🧩 Task Manager App

A full-stack Task Management application built with:

• Backend: FastAPI, SQLAlchemy, MySQL, Pydantic, Pytest
• Frontend: React (Vite), Material Tailwind, Axios, React Hook Form, Yup

---

🚀 Features

✅ Create, update, delete, and list tasks
✅ Mark tasks as completed or pending
✅ RESTful API with Pydantic validation
✅ Modern React interface with Material Tailwind
✅ Fully tested backend (Pytest + SQLite test DB)

---

⚙️ Backend Setup (FastAPI)

1️⃣ Create a virtual environment

   cd backend
   python -m venv venv
   venv\Scripts\activate    # On Windows
   source venv/bin/activate # On macOS/Linux

2️⃣ Install dependencies

   pip install -r requirements.txt

3️⃣ Configure environment variables

Copy .env.example → .env and update your database credentials:

   DATABASE_URL=mysql+mysqlconnector://root:password@localhost/task_db

4️⃣ Run the server

uvicorn app.main:app --reload

The API will be available at http://127.0.0.1:8000

5️⃣ API Documentation

• Swagger UI → http://127.0.0.1:8000/docs
• ReDoc → http://127.0.0.1:8000/redoc

---

🧪 Testing the Backend

Run all unit tests with coverage:

   pytest -v

Example output: tests/test_tasks.py::test_create_task PASSED [ 20%] tests/test_tasks.py::test_list_tasks PASSED [ 40%] tests/test_tasks.py::test_update_task PASSED [ 60%] tests/test_tasks.py::test_delete_task PASSED [ 80%] tests/test_tasks.py::test_delete_nonexistent_task PASSED [100%]

========================================= 5 passed in 8.42s =========================================

---

💻 Frontend Setup (React + Vite)

1️⃣ Install dependencies

cd frontend
npm install

2️⃣ Configure Axios base URL

In src/api/axios.js:

import axios from "axios";

export default axios.create({
  baseURL: "http://127.0.0.1:8000",
});

3️⃣ Start the development server

npm run dev

The app will run at http://localhost:5173

📸 Screenshots

Index Page

Add Task Modal

Update Task Modal

Delete Task Modal

🤝 Contributing

Contributions, suggestions, and improvements are welcome! Feel free to open an issue or submit a pull request.

👨‍💻 Author

• Selim Adekola
• 📧 salimdotpy@gmail.com
• 📞 +2348076738293