fastapi-todo

A full-stack Todo application built with FastAPI and React + Vite.

demo

🚀 Installation & Setup

1. Clone the repository

git clone https://github.com/saed-gpr/fastapi-todo.git
cd fastapi-todo

---

⚙️ Backend — FastAPI

2. Create a virtual environment

python -m venv venv

3. Activate the virtual environment

Windows:

venv\Scripts\activate

Linux / macOS:

source venv/bin/activate

4. Install dependencies

pip install -r requirements.txt

5. Run the FastAPI server

uvicorn app.main:app --reload

Backend will be available at:

http://localhost:8000

API documentation:

http://localhost:8000/docs

---

🎨 Frontend — React

Open a new terminal and go to the frontend directory:

cd frontend

6. Install dependencies

npm install

7. Start the development server

npm run dev

Frontend will be available at:

http://localhost:5173

---

🌐 Access the Application

Make sure both servers are running:

Service	URL
🎨 Frontend	http://localhost:5173
⚡ FastAPI	http://localhost:8000
📚 API Docs	http://localhost:8000/docs

Then open:

http://localhost:5173

---

📁 Project Structure

fastapi-todo/
│
├── app/
│   └── main.py
│
├── frontend/
│   ├── src/
│   ├── public/
│   ├── package.json
│   └── ...
│
├── requirements.txt
└── README.md

🛠️ Tech Stack

• FastAPI
• Python
• SQLAlchemy
• SQLite
• React
• Vite
• JavaScript

---

Saed Gholipour