Nextjs Fastapi Project Generator

Author: Adeniyi Aderounmu Email: teebarg01@gmail.com

🚨 Warning: still in construction 😎 🏗️

Generate a backend and frontend stack using Python, including interactive API documentation.

Interactive API documentation

Dashboard Login

Technology Stack and Features

• ⚡ FastAPI for the Python backend API.
  • 🧰 SQLModel for the Python SQL database interactions (ORM).
  • 🔍 Pydantic, used by FastAPI, for the data validation and settings management.
  • 💾 PostgreSQL as the SQL database.
• 🚀 Nextjs for the frontend.
  • 💃 Using TypeScript, hooks and other parts of a modern frontend stack.
  • 🎨 Tailwindcss for the frontend styling.
  • 🎨 Daisy UI for the frontend components.
  • 🤖 An automatically generated frontend client.
  • 🦇 Dark mode support.
• 🐋 Docker Compose for development and production.
• 🔒 Secure password hashing by default.
• 🔑 JWT token authentication.
• 📫 Email based password recovery.
• ✅ Tests with Pytest.
• 📞 Traefik as a reverse proxy / load balancer.
• 🚢 Deployment instructions using Docker Compose, including how to set up a frontend Traefik proxy to handle automatic HTTPS certificates.
• 🏭 CI (continuous integration) and CD (continuous deployment) based on GitHub Actions.

How to use it

You can just fork or clone this repository and use it as is.

✨ It just works. ✨

Configure

You can then update configs in the .env files to customize your configurations.

Before deploying it, make sure you change at least the values for:

• SECRET_KEY
• FIRST_SUPERUSER_PASSWORD
• POSTGRES_PASSWORD

Generate Secret Keys

Some environment variables in the .env file have a default value of changethis.

You have to change them with a secret key, to generate secret keys you can run the following command:

python -c "import secrets; print(secrets.token_urlsafe(32))"

Copy the content and use that as password / secret key. And run that again to generate another secure key.

How To Use It - Alternative With Copier

This repository also supports generating a new project using Copier.

It will copy all the files, ask you configuration questions, and update the .env files with your answers.

Install Copier

You can install Copier with:

pip install copier

Or better, if you have pipx, you can run it with:

pipx install copier

Note: If you have pipx, installing copier is optional, you could run it directly.

Generate a Project With Copier

Decide a name for your new project's directory, you will use it below. For example, my-awesome-project.

Go to the directory that will be the parent of your project, and run the command with your project's name:

copier copy https://github.com/teebarg/next-fast-template my-awesome-project --trust

If you have pipx and you didn't install copier, you can run it directly:

pipx run copier copy https://github.com/teebarg/next-fast-template my-awesome-project --trust

Note the --trust option is necessary to be able to execute a post-creation script that updates your .env files.

Generate passwords

You will be asked to provide passwords and secret keys for several components. Open another terminal and run:

openssl rand -hex 32
# Outputs something like: 99d3b1f01aa639e4a76f4fc281fc834747a543720ba4c8a8648ba755aef9be7f

Copy the contents and use that as password / secret key. And run that again to generate another secure key.

Input variables

Copier will ask you for some data, you might want to have at hand before generating the project.

But don't worry, you can just update any of that in the .env files afterwards.

The input variables, with their default values (some auto generated) are:

• project_name: (default: "Nextjs FastAPI Project") The name of the project, shown to API users (in .env).

• project_slug: The development friendly name of the project. By default, based on the project name

• stack_name: (default: "fastapi-project") The name of the stack used for Docker Compose labels (no spaces) (in .env).

• secret_key: (default: "changethis") The secret key for the project, used for security, stored in .env, you can generate one with the method above.

• first_superuser: (default: "admin@email.com") The email of the first superuser (in .env).

• first_superuser_password: (default: "changethis") The password of the first superuser (in .env).

• postgres_password: (default: "changethis") The password for the PostgreSQL database, stored in .env, you can generate one with the method above.

• nextauth_secret: Secret for Next Auth package.
• nextauth_url: Next Auth Url. Ex http://localhost:4000.
• next_public_domain: Nextjs Domain. Ex http://localhost:4000.
• image_url: Your image storage url.
• google_client_id: Google client id for auth, storage.
• google_client_secret: Google client secret.

Backend Development

Backend docs: backend/README.md.

Frontend Development

Frontend docs: frontend/README.md.

Deployment

Deployment docs: deployment.md.

Development

General development docs: development.md.

This includes using Docker Compose, custom local domains, .env configurations, etc.

License

The Full Stack FastAPI Template is licensed under the terms of the MIT license.