FARM Stack To-Do App

A full-stack task manager built with FastAPI, React, and MongoDB — the FARM stack. Demonstrates async CRUD operations from a React frontend through a FastAPI backend to a MongoDB collection, with all three tiers running locally via Docker Compose.

---

Features

• Create, read, update, and delete to-do tasks
• Async FastAPI backend with AsyncMongoClient (pymongo 4.x)
• React 18 frontend with Ant Design 5 timeline UI
• Auto-refreshing task list (polling every second)
• Seed-free: tasks persist in MongoDB across restarts
• Swagger UI at /docs for interactive API exploration

Tech Stack

Layer	Technology	Version
Backend	FastAPI + uvicorn	0.136+
Database	MongoDB (pymongo AsyncMongoClient)	4.17+
Frontend	React + Ant Design	18 / 5
Runtime	Python	3.13
Node	Node.js	22

Architecture Overview

Browser (React 18 + antd 5)
        │  fetch /task/
        ▼
FastAPI (uvicorn, port 8000)
  └─ /task  →  apps/todo/routers.py  →  AsyncMongoClient
                                               │
                                        MongoDB :27017
                                        database: farm_intro
                                        collection: tasks

Prerequisites

• Python 3.13+
• Node.js 22+
• Docker 24+ (for local MongoDB)
• MongoDB Atlas cluster or local Docker MongoDB

Quick Start

# 1. Clone
git clone https://github.com/mongodb-developer/FARM-Intro
cd FARM-Intro

# 2. Backend
cd backend
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
DB_URL="mongodb://localhost:27017/" DB_NAME="farm_intro" uvicorn main:app --reload
# API ready at http://localhost:8000  •  Swagger UI at http://localhost:8000/docs

# 3. Frontend (new terminal)
cd ../frontend
npm install
REACT_APP_BACKEND_URL=http://localhost:8000 npm start
# UI ready at http://localhost:3000