NautilusDesk Backend (FastAPI Starter)

FastAPI starter with PostgreSQL, JWT auth, and a clean project structure.

Quickstart

1. Create a virtualenv and install deps:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. Create your .env file:

cp .env.example .env

3. Start Postgres (example docker-compose below), or point to your own DB in .env.

4. Run the API:

uvicorn app.main:app --reload

Docker Postgres (optional)

version: "3.9"
services:
  db:
    image: postgres:16
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: nautilusdesk
    volumes:
      - postgres_data:/var/lib/postgresql/data
volumes:
  postgres_data:

Auth flow

• POST /api/v1/auth/register with JSON { "email": "user@example.com", "password": "secret" }
• POST /api/v1/auth/login with form fields username (email) + password
• Use Authorization: Bearer <token> for protected routes

Endpoints

• GET /api/v1/health
• POST /api/v1/auth/register
• POST /api/v1/auth/login
• GET /api/v1/users/me