Skip to content
amamam156Public

About

This is a project management application that includes a backend (built with Node.js/TypeScript and Prisma) and a frontend (built with React/TypeScript). It appears to support features such as task management, request handling, user authentication, and Kanban board views.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Cheers

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.

Cheers dashboard

What it does

  • 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

Product tour

AI Project Manager preview

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.

AI Project Manager preview

Tasks, from overview to detail

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
Task list Kanban board

Opening a task shows its assignment, current state, deadline, and activity history in one place.

Blocked task detail and activity history

Multi-step requests

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
Request overview Request approval flow

Built with

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.

Run locally

You will need Node.js 18 or newer and npm.

macOS quick start

Run the numbered .command files in order:

  1. 01_Install_Dependencies.command
  2. 02_Initialize_Database_and_Seed.command
  3. 03_Run_Backend.command
  4. 04_Run_Frontend.command

Manual setup

# 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 dev

In another terminal:

cd frontend
npm run dev

Open 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.

Project structure

Cheers/
├── frontend/          React application
├── backend/
│   ├── src/           Express routes and middleware
│   └── prisma/        Schema, migrations, and seed data
└── img/screenshots/   Raw screenshots from the running app

About

This is a project management application that includes a backend (built with Node.js/TypeScript and Prisma) and a frontend (built with React/TypeScript). It appears to support features such as task management, request handling, user authentication, and Kanban board views.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages