Eclipse — Fullstack ToDo App

Problem

Most todo apps are either too simple (no persistence, no sharing) or too complex. Developers need a well-structured, spec-driven example that demonstrates incremental build progression from CLI to full-stack.

My Approach

Built incrementally across 3 phases. Phase 1: Python CLI with in-memory storage and clean PEP 8 architecture. Phase 2: Full-stack web architecture. Phase 3: Production-grade Next.js 16 frontend with Zod validation + FastAPI backend with SQLModel, asyncpg (PostgreSQL), JWT auth, and OpenAI integration for AI-assisted task management.

Key Features

• Phase 1: Command-line todo with add, delete, update, list, and mark complete
• Phase 2: Full-stack web architecture with separation of concerns
• Phase 3: Type-safe Next.js 16 frontend with Zod schema validation
• Phase 3: FastAPI backend with SQLModel ORM and asyncpg PostgreSQL
• JWT authentication with bcrypt password hashing
• OpenAI integration for AI-assisted task management
• End-to-end testing with Playwright + unit tests with Vitest

Tech Stack