Full Stack FastAPI, React, MongoDB (FARM) Base Project Generator

Show your love for this project by starring our repo :star2:, so we can continue to innovate :slightly_smiling_face:

Accelerate your next web development project with this FastAPI/React/MongoDB base project generator.

This project is for developers looking to build and maintain full-feature progressive web applications using Python on the backend / Typescript on the frontend, and want the complex-but-routine aspects of auth 'n auth, and component and deployment configuration, taken care of, including interactive API documentation.

This is an experimental fork of Sebastián Ramírez's Full Stack FastAPI and PostgreSQL Base Project Generator and Whythawk's Full Stack FastAPI and PostgreSQL Base Project Generator. FastAPI is updated to version 0.103.2, MongoDB Motor 3.4, ODMantic ODM 1.0.0, and the frontend to React.

Index

• Requirements
• QuickStart
• Screenshots
• Key features
• How to use it
  • Building a generated app
  • Development and installation
  • Deployment for production
  • Authentication and magic tokens
  • Websockets for interactive communication
• More details
• Help needed
• Release notes
• License

Requirements

Please make sure you have these installed before proceeding!

• Docker Desktop
• Python 3.11+
• Cookiecutter -- The Python Cookiecutter library.
• Hatch
• Node.js
• MongoDB Compass -- To help visualize local/remote database easily.

QuickStart

NOTE This will generate a local application that is not yet production-ready. Please go through all of the README information linked before creating a version to deploy to a production host

For those that want to dive in and play around with the generated code, here's a quick start guide on how to do it. It is advised, though, once you have run through generating this app the first time, that you circle back and check out the more fleshed out Building a generated app section.

// Make sure cookiecutter and python are installed on the device
// This will generate a full-stack app in the directory ./example
cookiecutter https://github.com/mongodb-labs/full-stack-fastapi-mongodb --no-input project_name="example"

// Move into that directory.
cd example

// Make sure that you've opened the Docker Desktop app before this step.
// build
docker compose build --no-cache

// start the container in the background
docker compose up -d 

Now you can view the site by going to localhost:3000. You can also see all the logs of the running containers in your Docker Desktop app.

There will only be one user on the site: admin@example.com. If you choose a different project name, then the email domain changes. For example, if you create your project usingproject_name=fullstackexample the user email will be admin@fullstackexample.com. The default password will be set to changethis but that can be changed.

Here are all the local development URLS:

• Frontend -- http://localhost:3000
• Backend -- http://localhost/api/v1/
• Automatic Documentation via Swagger UI -- http://localhost/docs
• Alternative Documentation via ReDoc -- http://localhost/redoc
• Flower: Admin tool of Celery Tasks -- http://localhost:5555
• Traefik UI to see how routes are being handled by the proxy: http://localhost:8090

See Building a generated app for examples of what these pages look like.

Key features

This FastAPI, React, MongoDB repo will generate a complete web application stack as a foundation for your project development.

• Docker Compose integration and optimization for local development.
• Authentication user management schemas, models, crud and apis already built, with OAuth2 JWT token support & default hashing. Offers magic link authentication, with password fallback, with cookie management, including access and refresh tokens.
• FastAPI backend with Inboard one-repo Docker images:
  • MongoDB Motor https://motor.readthedocs.io/en/stable/
  • MongoDB ODMantic for handling ODM creation https://art049.github.io/odmantic/
  • Common CRUD support via generic inheritance.
  • Standards-based: Based on (and fully compatible with) the open standards for APIs: OpenAPI and JSON Schema.
  • Many other features: including automatic validation, serialization, interactive documentation, etc.
• Nextjs/React frontend:
  • Authorization route-based authentication, including support for detecting if a user is logged in or is a superuser.
  • Form validation with React useForm
  • State management with Redux
  • CSS and templates with TailwindCSS, HeroIcons, and HeadlessUI.
• Celery worker that can import and use models and code from the rest of the backend selectively.
• Flower for Celery jobs monitoring.
• Load balancing between frontend and backend with Traefik, so you can have both under the same domain, separated by path, but served by different containers.
• Traefik integration, including Let's Encrypt HTTPS certificates automatic generation.
• GitLab CI (continuous integration), including frontend and backend testing.

How to use the template

• Building a generated app
• Development and installation
• Deployment for production
• Authentication and magic tokens
• Websockets for interactive communication

More details

After using this generator, your new project (the directory created) will contain an extensive README.md with instructions for development, deployment, etc. You can pre-read the project README.md template here too.

This current release is for FastAPI version 0.103 and introduces support for Pydantic 2. Since this is intended as a base stack on which you will build complex applications, there is no intention of backwards compatability between releases, and the objective is to ensure that each release has the latest long-term-support versions of the core libraries so that you can rely on your application core for as long as possible.

To align with Inboard, Poetry has been deprecated in favour of Hatch. This will also, hopefully, sort out some Poetry-related Docker build errors.

Help needed

This project is currently experimental, so bugs or issues may occur. Please open an issue ticket against this repository to make us aware of issues and we will do our best to respond to them in a timely manner. Please leave feedback on features that would be very beneficial for developers who often leverage MongoDB in their FastAPI stack.

Release Notes

NOTE: There is no intention to have backwards compatibility between releases.

See notes:

CalVer 2024.01.10

• Replaced Beanie usage with ODMantic
• Fixed TOTP login
• Added Page-Level route authentication
• Fixed issued with logged in user being unable to access /settings page
• Throw errors on every non-ok auth.ts response
• Fixed Poject Named generation in Footer.tsx
• Removed unused CORS routes
• Updated README
  • Added QuickStart
  • Added Requirements
  • Added Container URL Information
• Updated docs/
  • Placed docker_example.png
  • Removed lingering Nuxt and Beanie references
  • Updated Indexing

CalVer 2023.11.10

• Replaced Next/Vue.js frontend framework with entirely React/Redux
• Replaced Backend native connection of PostgreSQL/SQLAlchemy with MongoDB Motor/Beanie ODM
• Removed Neo4j plugin
• Removed Alembic Usage
• Introduced new cookiecutter environment variables mongodb_uri, and mongo_database
• Introduced support for Pydantic 2

Historic changes from whythawk Historic changes from original

License

This project is licensed under the terms of the MIT license.