A modern todo application built with Next.js for the frontend and FastAPI for the backend. The application features real-time updates, AI-powered task summarization, and a clean, responsive interface.
- ✨ Modern, responsive UI built with Next.js
- 🚀 Fast and efficient FastAPI backend
- 🤖 AI-powered task summarization
- 🎨 Dark mode support
- ⚡ Real-time updates
- 🔄 Optimistic UI updates
- Next.js 15.0.3
- React 19
- TypeScript
- Tailwind CSS
- Lucide Icons
- FastAPI
- MongoDB
- Python 3.11+
- Motor (async MongoDB driver)
- Node.js 18+
- Python 3.11+
- MongoDB instance
- pnpm (recommended) or npm
- Python virtual environment
- Clone the repository:
git clone https://github.com/hsnlbnan/next-js-fast-api-mongodb-ollama-todo.git
cd next-js-fast-api-mongodb-ollama-todo
- Install frontend dependencies:
pnpm install
- Set up Python virtual environment:
python -m venv myenv
source myenv/bin/activate # On Windows: myenv\Scripts\activate
pip install -r requirements.txt
- Create a
.env
file in the root directory:
MONGO_DB_CLUSTER=your_mongodb_connection_string
- Start the development server:
pnpm dev
The application will be available at:
- Frontend: http://localhost:3000
- Backend: http://localhost:8000
- API Documentation: http://localhost:8000/api/docs
├── app/ # Next.js application
│ ├── actions/ # Server actions
│ ├── api/ # Backend API
│ ├── components/ # React components
│ ├── config/ # Configuration files
│ ├── hooks/ # Custom React hooks
│ └── types/ # TypeScript types
├── public/ # Static files
└── myenv/ # Python virtual environment
- Frontend development server:
pnpm next-dev
- Backend development server:
pnpm fastapi-dev
- Both servers concurrently:
pnpm dev
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request