- Getting started
- Development and installation
- Deployment for production
- Authentication and magic tokens
- Websockets for interactive communication
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
accessandrefreshtokens. - FastAPI backend with Inboard one-repo Docker images:
- Mongo Motor https://motor.readthedocs.io/en/stable/
- Mongo Beanie for handling ODM creation https://beanie-odm.dev/
- 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:
- Authorisation via middleware for page access, including logged in or superuser.
- Model blog project, with Nuxt Content for writing Markdown pages.
- Form validation with Vee-Validate 4.
- 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.
- Github Actions (continuous integration), including backend testing.
This project is a rock-solid foundation on which to build complex web applications which need parallel processing, scheduled event management, leveraging a NoSQL Datastore (MongoDB). The base deployment requires about 2Gb of memory to run.
This is not a light-weight system to deploy a blog or simple content-management-system.
It is for developers looking to build and maintain full feature progressive web applications that can run online, or offline, want the complex-but-routine aspects of auth 'n auth, and component and deployment configuration taken care of.
Running Cookiecutter to customise the deployment with your settings, and then building with Docker compose, takes about 20 minutes.
A Mongo connection can be set up one of two ways: At the cookiecutter generation step, provide the mongodb_uri, and mongo_database to inform the generator on how to connect to an Atlas cloud instance. Additionally, in the generated file, you can manually leave the .env.MONGO_DATABASE_URI as mongodb and it will automatically connect to the running mongodb docker instance.
Whilst the local instance is available, it is best advised to create or connect to a MongoDB Atlas Cluster.
This stack can be adjusted and used with several deployment options that are compatible with Docker Compose, but it is designed to be used in a cluster controlled with pure Docker in Swarm Mode with a Traefik main load balancer proxy handling automatic HTTPS certificates, using the ideas from DockerSwarm.rocks.
Time-based One-Time Password (TOTP) authentication extends the login process to include a challenge-response component where the user needs to enter a time-based token after their preferred login method.
After using this generator, your new project will contain an extensive README.md with instructions for development, deployment, etc. You can pre-read the project README.md template here too.
- Experimental release of FARM-stack generator app
This project is licensed under the terms of the MIT license.