Skip to content

README.md

Latest commit

 

History

History
75 lines (52 loc) · 2.27 KB

README.md

File metadata and controls

75 lines (52 loc) · 2.27 KB
Raw

starter-fullstack-python

A Skilluv starter — FastAPI + SQLAlchemy 2 + Alembic + PostgreSQL 18, SvelteKit 5 frontend.

CI License: MIT Skilluv

English

What this is

  • Backend: Python 3.12 + FastAPI + SQLAlchemy 2 + Alembic + psycopg v3 + Pydantic v2, managed with uv
  • Frontend: SvelteKit 5 (runes) + Tailwind v4
  • Orchestration: Docker Compose (postgres + backend + frontend)
  • Tests: pytest + ruff + mypy strict + Vitest + Playwright

Quickstart

git clone git@github.com:skilluv-community/starter-fullstack-python.git
cd starter-fullstack-python
cp .env.example .env
docker compose up --build

Structure

backend/     FastAPI app + SQLAlchemy models + Alembic migrations
frontend/    SvelteKit app (Svelte 5 runes, Tailwind v4)
docs/        Bilingual docs (fr, en)
.github/     CI + dependabot + PR template

What's inside

  • GET /health — liveness probe
  • GET /api/hello?name=Ada — greeting endpoint
  • GET/POST/DELETE /api/notes — CRUD demo (SQLAlchemy + PostgreSQL)
  • SvelteKit pages / and /notes

Docs

Français

Starter fullstack Python (FastAPI) + SvelteKit prêt-à-l'emploi. Voir docs/fr/getting-started.md et docs/fr/architecture.md.

git clone git@github.com:skilluv-community/starter-fullstack-python.git
cd starter-fullstack-python
cp .env.example .env
docker compose up --build

License

MIT — see LICENSE.

Related