ToDoRabbit

A sample monorepo todo list application demonstrating modern full-stack development practices and developer tooling for CodeRabbit AI code review.

Tech Stack

Backend:

• Python 3.11+
• FastAPI
• SQLAlchemy (async)
• SQLite
• Pydantic v2

Frontend:

• React 18+
• TypeScript
• Vite
• CSS Modules

Infrastructure:

• Docker
• Docker Compose
• nginx

Getting Started

Prerequisites

• Docker
• Docker Compose

Running the Application

Start all services:

make up

Or using Docker Compose directly:

docker compose up --build

Access the Application

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs

Project Structure

todo-app/
├── backend/           # FastAPI backend with async SQLAlchemy
├── frontend/          # React TypeScript frontend with Vite
├── docs/              # Getting started, API reference, configuration, deployment
├── website/           # Static landing page
├── docker-compose.yml # Service orchestration
├── Makefile          # Convenience commands
└── README.md         # This file

Documentation and Website

• docs/ contains the getting started guide, API reference, configuration options and deployment notes.
• website/ is a static landing page. Open website/index.html in a browser or serve the folder with any static file server.

Running Tests

Backend Tests

Run backend tests with pytest:

make test-backend

Frontend Checks

Run TypeScript type checking and the Vitest unit tests:

make test-frontend

All Tests

Run both backend tests and frontend checks (type check and unit tests):

make test

Development

Services can be run individually if needed:

• Backend: Runs on port 8000
• Frontend: Runs on port 3000

For local development without Docker, refer to the README files in the backend/ and frontend/ directories.

Stopping Services

Stop all running services:

make down

Cleanup

Remove all Docker volumes, containers, and build artifacts:

make clean