{"id":26593713,"url":"https://github.com/ayerna/taskflow","last_synced_at":"2026-04-12T13:52:53.798Z","repository":{"id":282102788,"uuid":"947497436","full_name":"ayerna/TaskFlow","owner":"ayerna","description":"TaskFlow: A modern, responsive task management application built with React, NestJS, and MongoDB.","archived":false,"fork":false,"pushed_at":"2025-03-12T20:01:31.000Z","size":11671,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T20:30:03.033Z","etag":null,"topics":["fullstack","javascript","mongodb","nestjs","project-management","react","responsive-ui","rest-api","task-management","taskmanager","typescript","ux-productivity","web-application"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ayerna.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-12T19:29:19.000Z","updated_at":"2025-03-12T20:06:10.000Z","dependencies_parsed_at":"2025-03-12T20:41:30.276Z","dependency_job_id":null,"html_url":"https://github.com/ayerna/TaskFlow","commit_stats":null,"previous_names":["ayerna/task-management"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayerna%2FTaskFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayerna%2FTaskFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayerna%2FTaskFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ayerna%2FTaskFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ayerna","download_url":"https://codeload.github.com/ayerna/TaskFlow/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245120143,"owners_count":20563863,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fullstack","javascript","mongodb","nestjs","project-management","react","responsive-ui","rest-api","task-management","taskmanager","typescript","ux-productivity","web-application"],"created_at":"2025-03-23T15:20:03.791Z","updated_at":"2026-04-12T13:52:53.713Z","avatar_url":"https://github.com/ayerna.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TaskFlow: Modern Task Management Application\n\nVersion\nLicense\nNestJS\nMongoDB\nReact\n\n\n  A beautiful and intuitive task management application to help you stay organized and productive.\n\n\n## ✨ Features\n\n- 📱 **Responsive Design** - Works flawlessly across all devices\n- 🌓 **Theme Switching** - Choose between light, dark, or system theme\n- 📋 **Task Organization** - Keep all your tasks in one place, categorized by status\n- ⏱️ **Progress Tracking** - Monitor task progress and stay on top of deadlines\n- 🎯 **Goal Achievement** - Break down goals into manageable tasks\n- 🔄 **CRUD Operations** - Create, read, update, and delete tasks with ease\n\n## 📸 Screenshots\n\n![Alt text](https://github.com/ayerna/TaskFlow/blob/main/taskFlow%20pics/1.png)\n![Alt text](https://github.com/ayerna/TaskFlow/blob/main/taskFlow%20pics/2.png)\n![Alt text](https://github.com/ayerna/TaskFlow/blob/main/taskFlow%20pics/3.png)\n![Alt text](https://github.com/ayerna/TaskFlow/blob/main/taskFlow%20pics/4.png)\n![Alt text](https://github.com/ayerna/TaskFlow/blob/main/taskFlow%20pics/5.png)\n![Alt text](https://github.com/ayerna/TaskFlow/blob/main/taskFlow%20pics/6.png)\n\n## 🛠️ Technology Stack\n\n### Frontend\n- **React** - Building UI components\n- **React Router** - Navigation management\n- **CSS/SCSS** - Styling and responsive design\n- **Context API** - State management (theme, tasks)\n\n### Backend\n- **NestJS** - Scalable and efficient server-side framework\n- **MongoDB** - NoSQL database for flexible data storage\n- **Mongoose** - MongoDB object modeling\n- **RESTful API** - Industry standard API architecture\n\n## 📋 Application Pages\n\n### Home Page\nDisplays a comprehensive list of all your tasks with:\n- Task titles for quick identification\n- Status indicators (pending, in-progress, completed)\n- Clean, intuitive interface\n\n### Task Detail Page\nProvides in-depth information about each task:\n- Complete title and description\n- Current status with visual indicators\n- Options to edit or delete\n\n### New Task Page\nA user-friendly form to create tasks with:\n- Title input field (required)\n- Detailed description field (required)\n- Status dropdown selection\n\n### Edit Task Page\nPre-populated form allowing you to:\n- Modify task title and description\n- Update task status\n- Save changes or cancel\n\n## 🔌 API Endpoints\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| `GET` | `/tasks` | Retrieve all tasks |\n| `GET` | `/tasks/:id` | Retrieve a specific task by ID |\n| `POST` | `/tasks` | Create a new task |\n| `PUT` | `/tasks/:id` | Update an existing task |\n| `DELETE` | `/tasks/:id` | Remove a task |\n\n## 📊 Data Model\n\n```typescript\nTask {\n  id: ObjectId,              // Unique identifier (MongoDB)\n  title: string,             // Short, descriptive title (required)\n  description: string,       // Detailed task information (required)\n  status: enum               // One of: 'pending', 'in-progress', 'completed'\n}\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Node.js (v14+)\n- MongoDB (local instance or Atlas)\n- npm or yarn\n\n### Backend Setup\n```bash\n# Clone the repository\ngit clone https://github.com/ayerna/taskflow.git\ncd taskflow/backend\n\n# Install dependencies\nnpm install\n\n# Configure environment variables\ncp .env.example .env\n# Edit .env with your MongoDB connection string\n\n# Start the development server\nnpm run start:dev\n```\n\n### Frontend Setup\n```bash\n# Navigate to frontend directory\ncd ../frontend\n\n# Install dependencies\nnpm install\n\n# Launch the application\nnpm start\n```\n\n## 🎨 Theme Options\n\nTaskFlow offers three theme options for optimal user experience:\n- **Light Mode** - Clean, bright interface\n- **Dark Mode** - Reduced eye strain in low-light environments\n- **System** - Automatically matches your device preferences\n\n## 🤝 Contributing\n\nContributions are welcome and appreciated! To contribute:\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📝 License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## 💡 Future Enhancements\n\n- User authentication\n- Task categories and tags\n- Due dates and reminders\n- Task priority levels\n- Collaborative features\n\n---\n\n\n  TaskFlow - Manage your tasks with ease and boost your productivity!\n\n\n\n  Made with ❤️ by Gladwin Benjamin aka ayerna\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayerna%2Ftaskflow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fayerna%2Ftaskflow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fayerna%2Ftaskflow/lists"}