Skip to content

A FastAPI based low code starter/boilerplate: SQLAlchemy 2.0 (async), Postgres, React-Admin, pytest and cypress

License

Notifications You must be signed in to change notification settings

baseline0/fastapi-starter

 
 

Repository files navigation

FastAPI-Starter

All Contributors

GitHub Workflow Status (with event) GitHub last commit (branch)

A FastAPI based starter that relies heavily on existing plugins/frameworks. Integrates with OpenAPI Generator for a Typescript client, FastAPI Users for authentication, async-first with SQLAlchemy 2.0.


Features

  • Uses best practices: Factory pattern and environment variables for configuration
  • User registration, models, authentication using FastAPI Users
  • Modern admin interface using React-Admin
  • Github Action for building docker images and running automated tests
  • Dependabot config to keep project dependencies up to date
  • Create Typescript bindings for front-end automatically from OpenAPI spec using OpenAPI-Generator, no need to write/update code when backend changes
  • Async-first codebase with SQLAlchemy 2.0 and Alembic for database migrations
  • pytest with example tests included
  • Integration tests with Cypress
  • Docker images for frontend and backend
  • Includes extra Dockerfile (backend serves frontend) for straightforward production deployment
  • Pre-commit hooks with Black, autoflake, isort, flake8, prettier, eslint for consistent code standards

How to use

You need Python 3 and pip installed locally. Run the cookiecutter command (at least 1.7) and you'll be asked a few prompts.

pip3 install cookiecutter
cookiecutter https://github.com/gaganpreet/fastapi-starter

Input variables

The generator (cookiecutter) will ask you for some data, you might want to have at hand before generating the project.

The input variables, with their default values [default value], are:

  • project_name: The name of the project
  • project_slug: The development-friendly name of the project. By default, based on the project name.
  • backend_port: The backend port on the localhost.
  • front_end_port: The frontend port on the localhost.

If you want to keep up to date with upstream changes (i.e. changes in this template), then it's better to use Cruft, which is fully compatible with Cookiecutter.

pip3 install cruft
cruft create https://github.com/gaganpreet/fastapi-starter

Using cruft will generate a metadata file named .cruft.json (don't delete it). Later on you can update to the current version of this cookiecutter and import the changes to your generated project by running this command:

cruft update

Objectives

  • Sane defaults with few prompts
  • Secure
  • KISS principle

Preview

View live demo here.

Login page

Item page

Features not included

The following features were left out in favour of simplicity:

Things to do

  • Migrate to Ruff
  • Email templates

Contributors ✨

Thanks goes to these wonderful people (emoji key):

nadavof
nadavof

📖
Dustin Davis
Dustin Davis

📖
Hugo Tinoco
Hugo Tinoco

📖 💻
Michael Bunsen
Michael Bunsen

💻
Alexey Sveshnikov
Alexey Sveshnikov

💻
Javier Aranda Santos
Javier Aranda Santos

💻
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!

About

A FastAPI based low code starter/boilerplate: SQLAlchemy 2.0 (async), Postgres, React-Admin, pytest and cypress

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 68.1%
  • Python 21.1%
  • JavaScript 4.0%
  • Shell 3.0%
  • HTML 1.4%
  • Dockerfile 1.3%
  • Other 1.1%