Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/iyosias--mcp-server-task-tracker/badge.svg)](/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

i

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
  1. # Task Tracker
  2. **Credit - An App I designed following a tutorial from frontend masters by [Brian Holt](https://mcp.holt.courses/)**
  3. A modern, full-stack task tracking application built with React, Fastify, and SQLite.
  4. ## Features
  5. - 🔐 **Authentication** - Secure user authentication with BetterAuth
  6. - 📝 **Task Management** - Create, read, update, and delete tasks
  7. - 🏷️ **Tag System** - Organize tasks with customizable tags
  8. - 🔍 **Advanced Filtering** - Filter by status, priority, assignee, tags, and search
  9. - 👥 **User Management** - Assign tasks to team members
  10. - 📱 **Responsive Design** - Works great on desktop and mobile
  11. - ⚡ **Fast & Modern** - Built with modern web technologies
  12. ## Tech Stack
  13. ### Backend
  14. - **Fastify** - High-performance Node.js web framework
  15. - **SQLite** - Lightweight, embedded database
  16. - **BetterAuth** - Modern authentication library
  17. - **TypeScript** - Type-safe JavaScript
  18. ### Frontend
  19. - **React 18** - Modern React with hooks
  20. - **Vite** - Fast build tool and dev server
  21. - **Tailwind CSS** - Utility-first CSS framework
  22. - **shadcn/ui** - Beautiful, accessible components
  23. - **TypeScript** - Type-safe JavaScript
  24. ## Project Structure
  25. ```
  26. ├── backend/ # Fastify API server
  27. │ ├── src/
  28. │ │ └── index.ts # Main server file
  29. │ ├── package.json
  30. │ └── tsconfig.json
  31. ├── frontend/ # React application
  32. │ ├── src/
  33. │ │ ├── App.tsx
  34. │ │ ├── main.tsx
  35. │ │ └── lib/
  36. │ │ └── utils.ts
  37. │ ├── package.json
  38. │ └── tsconfig.json
  39. └── package.json # Root workspace configuration
  40. ```
  41. ## Getting Started
  42. ### Prerequisites
  43. - Node.js 18+ and npm
  44. - Git
  45. ### Installation
  46. 1. **Clone the repository**
  47. ```bash
  48. git clone <your-repo-url>
  49. cd tasks
  50. ```
  51. 2. **Set up the backend**
  52. ```bash
  53. cd backend
  54. npm install
  55. # Copy environment template and configure
  56. cp .env.template .env
  57. # Edit .env with your settings
  58. # Run database migrations
  59. npm run migrate
  60. # Seed with sample data (optional)
  61. npm run seed
  62. ```
  63. 3. **Set up the frontend**
  64. ```bash
  65. cd ../frontend
  66. npm install
  67. # Copy environment template and configure
  68. cp .env.template .env
  69. # Edit .env with your settings
  70. ```
  71. 4. **Start the development servers**
  72. From the project root:
  73. ```bash
  74. npm run dev
  75. ```
  76. Or start individually:
  77. ```bash
  78. # Backend (in backend/ directory)
  79. npm run dev
  80. # Frontend (in frontend/ directory)
  81. npm run dev
  82. ```
  83. 5. **Access the application**
  84. - Frontend: http://localhost:5173
  85. - Backend API: http://localhost:3000
  86. - Health check: http://localhost:3000/health
  87. ## Environment Configuration
  88. ### Backend (.env)
  89. ```env
  90. DATABASE_PATH=database.sqlite
  91. BETTER_AUTH_SECRET=your-super-secret-auth-key-change-this-in-production
  92. BETTER_AUTH_BASE_URL=http://localhost:3000
  93. PORT=3000
  94. HOST=0.0.0.0
  95. NODE_ENV=development
  96. FRONTEND_URL=http://localhost:5173
  97. LOG_LEVEL=info
  98. ```
  99. ### Frontend (.env)
  100. ```env
  101. VITE_API_URL=http://localhost:3000/api
  102. VITE_NODE_ENV=development
  103. ```
  104. ## Available Scripts
  105. ### Root Scripts
  106. - `npm run dev` - Start both frontend and backend in development mode
  107. - `npm run build` - Build both frontend and backend for production
  108. - `npm run test` - Run all tests (frontend + backend)
  109. ### Backend Scripts
  110. - `npm run dev` - Start development server with hot reload
  111. - `npm run build` - Build for production
  112. - `npm run start` - Start production server
  113. - `npm run test` - Run test suite
  114. - `npm run test:watch` - Run tests in watch mode
  115. - `npm run migrate` - Run database migrations
  116. - `npm run seed` - Seed database with sample data
  117. ### Frontend Scripts
  118. - `npm run dev` - Start development server
  119. - `npm run build` - Build for production
  120. - `npm run preview` - Preview production build
  121. - `npm run test` - Run test suite
  122. - `npm run lint` - Run ESLint
  123. ## API Documentation
  124. ### Authentication Endpoints
  125. - `POST /api/auth/sign-up/email` - User registration
  126. - `POST /api/auth/sign-in/email` - User login
  127. - `POST /api/auth/sign-out` - User logout
  128. - `GET /api/auth/get-session` - Get current user session
  129. ### Tasks API
  130. - `GET /api/tasks` - List tasks with filtering and pagination
  131. - `POST /api/tasks` - Create new task
  132. - `GET /api/tasks/:id` - Get task by ID
  133. - `PUT /api/tasks/:id` - Update task
  134. - `DELETE /api/tasks/:id` - Delete task
  135. ### Tags API
  136. - `GET /api/tags` - List all tags
  137. - `POST /api/tags` - Create new tag
  138. - `DELETE /api/tags/:id` - Delete tag
  139. ### Users API
  140. - `GET /api/users` - List users (for assignment)
  141. ### Health Check
  142. - `GET /health` - Application health status
  143. - `GET /health/ready` - Readiness probe
  144. - `GET /health/live` - Liveness probe
  145. ## Testing
  146. Run the comprehensive test suite:
  147. ```bash
  148. # All tests
  149. npm run test
  150. # Backend tests only
  151. cd backend && npm test
  152. # Frontend tests only
  153. cd frontend && npm test
  154. # Watch mode
  155. npm run test:watch
  156. ```
  157. ### Test Coverage
  158. - **Backend**: 85 tests covering CRUD operations, authentication, filtering, error scenarios
  159. - **Frontend**: 15 tests covering responsive design and component behavior
  160. **Sample Users:**
  161. - `john@example.com` / `password123`
  162. - `jane@example.com` / `password123`
  163. - `admin@example.com` / `admin123`
  164. - `dev@example.com` / `dev123`
  165. ## Contributing
  166. 1. Fork the repository
  167. 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
  168. 3. Commit your changes (`git commit -m 'Add some amazing feature'`)
  169. 4. Push to the branch (`git push origin feature/amazing-feature`)
  170. 5. Open a Pull Request
  171. ## License
  172. This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
  173. ## Support
  174. 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 in

Free to use. If it’s helped, pass it on.