minimalistic-fastapi

Simple but complete and scalable FastAPI & PostgreSQL API.

Deploy minimalistic-fastapi

minimalistic-fastapi-template

luchog01/minimalistic-fastapi-template

Just deployed

Postgres

railwayapp-templates/postgres-ssl:16

Just deployed

/var/lib/postgresql/data

What's Included

  • ๐Ÿ”„ Complete CRUD operations for heroes
  • ๐Ÿ“Š Async SQLAlchemy with PostgreSQL
  • ๐Ÿ”„ Automatic Alembic migrations
  • ๐Ÿ—๏ธ Clean architecture with repository pattern
  • โš ๏ธ Custom exception handling
  • ๐Ÿ” CI and testing pipeline
  • ๐Ÿงน Linter setup with pre-commit hooks
  • ๐Ÿš‚ One-click Railway deployment

Project Structure ๐Ÿ“

api/
โ”œโ”€โ”€ core/              # Core functionality
โ”‚   โ”œโ”€โ”€ config.py      # Environment and app configuration
โ”‚   โ”œโ”€โ”€ database.py    # Database connection and sessions
โ”‚   โ”œโ”€โ”€ exceptions.py  # Global exception handlers
โ”‚   โ”œโ”€โ”€ logging.py     # Logging configuration
โ”‚   โ””โ”€โ”€ security.py    # Authentication and security
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ heroes/        # Heroes module
โ”‚   โ”‚   โ”œโ”€โ”€ models.py      # Database models
โ”‚   โ”‚   โ”œโ”€โ”€ repository.py  # Data access layer
โ”‚   โ”‚   โ”œโ”€โ”€ routes.py      # API endpoints
โ”‚   โ”‚   โ””โ”€โ”€ schemas.py     # Pydantic models
โ”‚   โ””โ”€โ”€ users/         # Users module
โ”‚       โ”œโ”€โ”€ models.py      # User models
โ”‚       โ”œโ”€โ”€ repository.py  # User data access
โ”‚       โ”œโ”€โ”€ routes.py      # User endpoints
โ”‚       โ””โ”€โ”€ schemas.py     # User schemas
โ”œโ”€โ”€ utils/            # Utility functions
โ””โ”€โ”€ main.py          # Application entry point

Note: Railway will automatically detect the Python requirements and set up the necessary infrastructure.


Template Content

More templates in this category

View Template

mellow-vue

A full-stack Vue app with The Boring JavaScript Stack.


View Template

Sveltekit NestJS

Full-stack with SvelteKit + NestJS + Prisma + Postgresql with utils


View Template

.NET8 Web API

A basic ASP.NET Core Web API template (.NET 8)