mcp-server-task-tracker
A full-stack task tracker app with mcp-server integration
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/iyosias--mcp-server-task-tracker)HTML
<a href="/listings/iyosias--mcp-server-task-tracker"><img src="/api/listings/iyosias--mcp-server-task-tracker/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Prerequisites
- Node.js 18+ and npm - Git
Installation
1. **Clone the repository**
git clone <your-repo-url> cd tasks
2. **Set up the backend**
cd backend npm install # Copy environment template and configure cp .env.template .env # Edit .env with your settings # Run database migrations npm run migrate # Seed with sample data (optional) npm run seed
3. **Set up the frontend**
cd ../frontend npm install # Copy environment template and configure cp .env.template .env # Edit .env with your settings
4. **Start the development servers**
From the project root:
npm run dev
Or start individually:
# Backend (in backend/ directory) npm run dev # Frontend (in frontend/ directory) npm run dev
5. **Access the application** - Frontend: http://localhost:5173 - Backend API: http://localhost:3000 - Health check: http://localhost:3000/health
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 244 lines
- # Task Tracker
- **Credit - An App I designed following a tutorial from frontend masters by [Brian Holt](https://mcp.holt.courses/)**
- A modern, full-stack task tracking application built with React, Fastify, and SQLite.
- ## Features
- - 🔐 **Authentication** - Secure user authentication with BetterAuth
- - 📝 **Task Management** - Create, read, update, and delete tasks
- - 🏷️ **Tag System** - Organize tasks with customizable tags
- - 🔍 **Advanced Filtering** - Filter by status, priority, assignee, tags, and search
- - 👥 **User Management** - Assign tasks to team members
- - 📱 **Responsive Design** - Works great on desktop and mobile
- - ⚡ **Fast & Modern** - Built with modern web technologies
- ## Tech Stack
- ### Backend
- - **Fastify** - High-performance Node.js web framework
- - **SQLite** - Lightweight, embedded database
- - **BetterAuth** - Modern authentication library
- - **TypeScript** - Type-safe JavaScript
- ### Frontend
- - **React 18** - Modern React with hooks
- - **Vite** - Fast build tool and dev server
- - **Tailwind CSS** - Utility-first CSS framework
- - **shadcn/ui** - Beautiful, accessible components
- - **TypeScript** - Type-safe JavaScript
- ## Project Structure
- ```
- ├── backend/ # Fastify API server
- │ ├── src/
- │ │ └── index.ts # Main server file
- │ ├── package.json
- │ └── tsconfig.json
- ├── frontend/ # React application
- │ ├── src/
- │ │ ├── App.tsx
- │ │ ├── main.tsx
- │ │ └── lib/
- │ │ └── utils.ts
- │ ├── package.json
- │ └── tsconfig.json
- └── package.json # Root workspace configuration
- ```
- ## Getting Started
- ### Prerequisites
- - Node.js 18+ and npm
- - Git
- ### Installation
- 1. **Clone the repository**
- ```bash
- git clone <your-repo-url>
- cd tasks
- ```
- 2. **Set up the backend**
- ```bash
- cd backend
- npm install
- # Copy environment template and configure
- cp .env.template .env
- # Edit .env with your settings
- # Run database migrations
- npm run migrate
- # Seed with sample data (optional)
- npm run seed
- ```
- 3. **Set up the frontend**
- ```bash
- cd ../frontend
- npm install
- # Copy environment template and configure
- cp .env.template .env
- # Edit .env with your settings
- ```
- 4. **Start the development servers**
- From the project root:
- ```bash
- npm run dev
- ```
- Or start individually:
- ```bash
- # Backend (in backend/ directory)
- npm run dev
- # Frontend (in frontend/ directory)
- npm run dev
- ```
- 5. **Access the application**
- - Frontend: http://localhost:5173
- - Backend API: http://localhost:3000
- - Health check: http://localhost:3000/health
- ## Environment Configuration
- ### Backend (.env)
- ```env
- DATABASE_PATH=database.sqlite
- BETTER_AUTH_SECRET=your-super-secret-auth-key-change-this-in-production
- BETTER_AUTH_BASE_URL=http://localhost:3000
- PORT=3000
- HOST=0.0.0.0
- NODE_ENV=development
- FRONTEND_URL=http://localhost:5173
- LOG_LEVEL=info
- ```
- ### Frontend (.env)
- ```env
- VITE_API_URL=http://localhost:3000/api
- VITE_NODE_ENV=development
- ```
- ## Available Scripts
- ### Root Scripts
- - `npm run dev` - Start both frontend and backend in development mode
- - `npm run build` - Build both frontend and backend for production
- - `npm run test` - Run all tests (frontend + backend)
- ### Backend Scripts
- - `npm run dev` - Start development server with hot reload
- - `npm run build` - Build for production
- - `npm run start` - Start production server
- - `npm run test` - Run test suite
- - `npm run test:watch` - Run tests in watch mode
- - `npm run migrate` - Run database migrations
- - `npm run seed` - Seed database with sample data
- ### Frontend Scripts
- - `npm run dev` - Start development server
- - `npm run build` - Build for production
- - `npm run preview` - Preview production build
- - `npm run test` - Run test suite
- - `npm run lint` - Run ESLint
- ## API Documentation
- ### Authentication Endpoints
- - `POST /api/auth/sign-up/email` - User registration
- - `POST /api/auth/sign-in/email` - User login
- - `POST /api/auth/sign-out` - User logout
- - `GET /api/auth/get-session` - Get current user session
- ### Tasks API
- - `GET /api/tasks` - List tasks with filtering and pagination
- - `POST /api/tasks` - Create new task
- - `GET /api/tasks/:id` - Get task by ID
- - `PUT /api/tasks/:id` - Update task
- - `DELETE /api/tasks/:id` - Delete task
- ### Tags API
- - `GET /api/tags` - List all tags
- - `POST /api/tags` - Create new tag
- - `DELETE /api/tags/:id` - Delete tag
- ### Users API
- - `GET /api/users` - List users (for assignment)
- ### Health Check
- - `GET /health` - Application health status
- - `GET /health/ready` - Readiness probe
- - `GET /health/live` - Liveness probe
- ## Testing
- Run the comprehensive test suite:
- ```bash
- # All tests
- npm run test
- # Backend tests only
- cd backend && npm test
- # Frontend tests only
- cd frontend && npm test
- # Watch mode
- npm run test:watch
- ```
- ### Test Coverage
- - **Backend**: 85 tests covering CRUD operations, authentication, filtering, error scenarios
- - **Frontend**: 15 tests covering responsive design and component behavior
- **Sample Users:**
- - `john@example.com` / `password123`
- - `jane@example.com` / `password123`
- - `admin@example.com` / `admin123`
- - `dev@example.com` / `dev123`
- ## Contributing
- 1. Fork the repository
- 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
- 3. Commit your changes (`git commit -m 'Add some amazing feature'`)
- 4. Push to the branch (`git push origin feature/amazing-feature`)
- 5. Open a Pull Request
- ## License
- This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
- ## Support
- If you encounter any tasks or have questions, please [open an task](https://github.com/your-username/tasks/tasks) on GitHub.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.