Cheers is a small, self-hosted project tracker built around two everyday workflows: managing team tasks and reviewing internal requests.
It started as a full-stack practice project. The current version includes a dashboard, list and Kanban views, task history, and a multi-step request approval flow.
- Create and assign tasks with priorities and due dates
- Move work between Todo, In Progress, Blocked, and Completed
- Record status changes, including block and unblock reasons
- View the same tasks as a list or a drag-and-drop Kanban board
- Submit requests and route them through multiple reviewers
- Track request form revisions and approval history
- Register and sign in with role-based user accounts
- Preview an AI project manager briefing built from workspace data
The AI workspace is a front-end preview of the planned assistant. It reads current tasks and requests to present today's priorities, blocked work, and pending approvals. The question box currently uses local demo responses; no external AI model is connected yet.
The task list is designed for scanning ownership, deadlines, status, and priority. The Kanban view uses the same data when a visual workflow is more useful.
| Task list | Kanban board |
|---|---|
![]() |
![]() |
Opening a task shows its assignment, current state, deadline, and activity history in one place.
Requests are separate from day-to-day tasks. The overview shows who needs to act next, while the detail page keeps the submitted data, approval stages, and audit trail together.
| Request overview | Approval flow and history |
|---|---|
![]() |
![]() |
| Frontend | Backend | Data |
|---|---|---|
| React, TypeScript, Vite | Express, TypeScript, JWT | Prisma, SQLite |
The UI also uses dnd-kit for Kanban interactions and Recharts for dashboard charts.
You will need Node.js 18 or newer and npm.
Run the numbered .command files in order:
01_Install_Dependencies.command02_Initialize_Database_and_Seed.command03_Run_Backend.command04_Run_Frontend.command
# Install dependencies
cd backend && npm install
cd ../frontend && npm install
# Configure and seed the local database
cd ../backend
cp env.example.txt .env
npm run db:init
# Start the API
npm run devIn another terminal:
cd frontend
npm run devOpen http://localhost:5173. The API runs at http://localhost:3000.
The seed script creates demo users. For example:
Username: John
Password: password123
Demo credentials are intended for local development only. Change JWT_SECRET and remove or replace the seeded accounts before using the project outside your machine.
Cheers/
├── frontend/ React application
├── backend/
│ ├── src/ Express routes and middleware
│ └── prisma/ Schema, migrations, and seed data
└── img/screenshots/ Raw screenshots from the running app






