{"id":25639290,"url":"https://github.com/abdallah4z/nomeda-taskhub","last_synced_at":"2026-04-07T07:02:55.925Z","repository":{"id":278780581,"uuid":"936039398","full_name":"Abdallah4Z/Nomeda-TaskHub","owner":"Abdallah4Z","description":"A smart and efficient task management system designed to simplify planning, prioritize tasks, and enhance productivity","archived":false,"fork":false,"pushed_at":"2025-02-21T16:25:08.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-21T17:29:13.688Z","etag":null,"topics":["docker","figma","firebase","js","jwt","mongodb","nodejs","python","react","sockets","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":null,"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/Abdallah4Z.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-02-20T12:36:16.000Z","updated_at":"2025-02-21T16:35:48.000Z","dependencies_parsed_at":"2025-02-21T17:40:29.518Z","dependency_job_id":null,"html_url":"https://github.com/Abdallah4Z/Nomeda-TaskHub","commit_stats":null,"previous_names":["abdallah4z/nomeda-taskhub"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdallah4Z%2FNomeda-TaskHub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdallah4Z%2FNomeda-TaskHub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdallah4Z%2FNomeda-TaskHub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Abdallah4Z%2FNomeda-TaskHub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Abdallah4Z","download_url":"https://codeload.github.com/Abdallah4Z/Nomeda-TaskHub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240265402,"owners_count":19774070,"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":["docker","figma","firebase","js","jwt","mongodb","nodejs","python","react","sockets","tailwindcss"],"created_at":"2025-02-23T03:29:23.455Z","updated_at":"2025-12-30T18:58:00.969Z","avatar_url":"https://github.com/Abdallah4Z.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nomeda-TaskHub\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Nomeda/src/assets/logo.png\" alt=\"Nomeda-TaskHub Logo\" width=\"200\"/\u003e\n  \u003cbr\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/YourUsername/Nomeda-TaskHub/issues\"\u003e\n      \u003cimg alt=\"Issues\" src=\"https://img.shields.io/github/issues/YourUsername/Nomeda-TaskHub?color=0088ff\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/YourUsername/Nomeda-TaskHub/pulls\"\u003e\n      \u003cimg alt=\"Pull requests\" src=\"https://img.shields.io/github/issues-pr/YourUsername/Nomeda-TaskHub?color=0088ff\" /\u003e\n    \u003c/a\u003e\n    \u003cimg alt=\"Node.js\" src=\"https://img.shields.io/badge/node.js-%2343853D.svg?style=flat\u0026logo=node.js\u0026logoColor=white\"/\u003e\n    \u003cimg alt=\"React\" src=\"https://img.shields.io/badge/react-%2320232a.svg?style=flat\u0026logo=react\u0026logoColor=%2361DAFB\"/\u003e\n    \u003cimg alt=\"MongoDB\" src=\"https://img.shields.io/badge/MongoDB-%234ea94b.svg?style=flat\u0026logo=mongodb\u0026logoColor=white\"/\u003e\n    \u003cimg alt=\"TypeScript\" src=\"https://img.shields.io/badge/typescript-%23007ACC.svg?style=flat\u0026logo=typescript\u0026logoColor=white\"/\u003e\n  \u003c/p\u003e\n  \u003cp\u003e\u003cstrong\u003eA collaborative platform designed to streamline project management, team communication, and file sharing.\u003c/strong\u003e\u003c/p\u003e\n\u003c/div\u003e\n\n## 📋 Table of Contents\n\n- [Overview](#overview)\n- [✨ Features](#-features)\n- [📸 Screenshots](#-screenshots)\n- [🛠️ Tech Stack](#️-tech-stack)\n- [📁 Project Structure](#-project-structure)\n- [🚀 Getting Started](#-getting-started)\n- [🔧 Environment Variables](#-environment-variables)\n- [📚 API Documentation](#-api-documentation)\n- [📝 Roadmap](#-roadmap)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n\n## Overview\n\nNomeda-TaskHub is a comprehensive platform featuring real-time chat, task\ntracking, authentication (including Google and GitHub), and a modern, responsive\nUI designed for teams to collaborate efficiently.\n\n## ✨ Features\n\n- **Real-time Communication**\n\n  - Chat messaging with instant notifications\n  - File sharing in conversations\n  - Read receipts and typing indicators\n\n- **Project Management**\n\n  - Kanban-style task boards\n  - Task assignments and deadline tracking\n  - Progress visualization and reporting\n\n- **User Authentication**\n\n  - JWT token-based authentication\n  - OAuth integration (Google, GitHub)\n  - Role-based access control\n\n- **Dashboard \u0026 Analytics**\n\n  - Project progress metrics\n  - Team productivity insights\n  - Custom reporting options\n\n- **Additional Features**\n  - Multi-language support (English, Spanish, Arabic)\n  - Dark/Light theme options\n  - Responsive design for mobile and desktop\n  - File uploads with preview capabilities\n\n## 📸 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"Nomeda/src/assets/dashboard.png\" alt=\"Dashboard\" width=\"400\"/\u003e\n  \u003cimg src=\"Nomeda/src/assets/tasks.png\" alt=\"Task Management\" width=\"400\"/\u003e\n  \u003cbr\u003e\n  \u003cimg src=\"Nomeda/src/assets/chatbot.png\" alt=\"Chat Interface\" width=\"400\"/\u003e\n\u003c/div\u003e\n\n## 🛠️ Tech Stack\n\n### Frontend\n\n- **Framework**: React 18 with TypeScript\n- **Build Tool**: Vite for fast development\n- **State Management**: Context API\n- **Styling**: CSS Modules / Styled Components\n- **Internationalization**: i18next\n- **APIs**: Fetch API, Socket.io client\n\n### Backend\n\n- **Runtime**: Node.js with Express\n- **Language**: TypeScript\n- **Database**: MongoDB with Mongoose ODM\n- **Real-time**: Socket.IO\n- **Authentication**: JWT, Passport.js (OAuth)\n- **File Storage**: Local with multer (cloud storage ready)\n\n### DevOps \u0026 Tools\n\n- **Linting**: ESLint, Prettier\n- **Version Control**: Git, GitHub\n- **API Documentation**: Swagger/OpenAPI\n- **Testing**: Jest, React Testing Library\n\n## 📁 Project Structure\n\n```\nNomeda-TaskHub/\n├── backend/           # Node.js/Express API, Socket.IO, MongoDB models\n│   ├── src/\n│   │   ├── controllers/  # Request handlers\n│   │   ├── middleware/   # Auth and validation middleware\n│   │   ├── models/       # MongoDB schema definitions\n│   │   ├── routes/       # API endpoint definitions\n│   │   ├── sockets/      # Real-time communication logic\n│   │   └── config/       # Environment configuration\n│   └── uploads/          # Uploaded files (temporary storage)\n│\n├── Nomeda/            # React frontend (Vite, TypeScript)\n│   ├── src/\n│   │   ├── components/   # Reusable UI components\n│   │   ├── pages/        # Application views/screens\n│   │   ├── hooks/        # Custom React hooks\n│   │   ├── context/      # Global state management\n│   │   ├── assets/       # Images, icons, static files\n│   │   └── locales/      # Translation files\n│   └── public/           # Static assets served directly\n└── README.md\n```\n\n## 🚀 Getting Started\n\n### Prerequisites\n\n- Node.js 16.x or later\n- MongoDB 4.4+ running locally or MongoDB Atlas account\n- npm or yarn package manager\n\n### Backend Setup\n\n1. Clone the repository\n\n   ```bash\n   git clone https://github.com/YourUsername/Nomeda-TaskHub.git\n   cd Nomeda-TaskHub\n   ```\n\n2. Install dependencies\n\n   ```bash\n   cd backend\n   npm install\n   ```\n\n3. Set up environment variables\n\n   ```bash\n   cp .env.example .env\n   # Edit .env with your configuration\n   ```\n\n4. Start the development server\n   ```bash\n   npm run dev\n   ```\n\n### Frontend Setup\n\n1. Install dependencies\n\n   ```bash\n   cd Nomeda\n   npm install\n   ```\n\n2. Set up environment variables\n\n   ```bash\n   cp .env.example .env\n   # Edit .env with your configuration\n   ```\n\n3. Start the development server\n\n   ```bash\n   npm run dev\n   ```\n\n4. Build for production\n   ```bash\n   npm run build\n   ```\n\n## 🔧 Environment Variables\n\n### Backend (.env)\n\n```\nNODE_ENV=development\nPORT=3000\nMONGODB_URI=mongodb://localhost:27017/nomeda-taskhub\nJWT_SECRET=your_jwt_secret_key\nJWT_EXPIRES_IN=7d\nGOOGLE_CLIENT_ID=your_google_client_id\nGOOGLE_CLIENT_SECRET=your_google_client_secret\nGITHUB_CLIENT_ID=your_github_client_id\nGITHUB_CLIENT_SECRET=your_github_client_secret\nUPLOAD_DIR=./uploads\n```\n\n### Frontend (.env)\n\n```\nVITE_API_URL=http://localhost:3000/api\nVITE_SOCKET_URL=http://localhost:3000\nVITE_GOOGLE_CLIENT_ID=your_google_client_id\n```\n\n## 📚 API Documentation\n\n### Authentication\n\n- `POST /api/auth/register` - Register new user\n- `POST /api/auth/login` - User login\n- `GET /api/auth/google` - Google OAuth login\n- `GET /api/auth/github` - GitHub OAuth login\n- `GET /api/auth/profile` - Get current user profile\n\n### Projects\n\n- `GET /api/projects` - Get all projects\n- `POST /api/projects` - Create new project\n- `GET /api/projects/:id` - Get project details\n- `PUT /api/projects/:id` - Update project\n- `DELETE /api/projects/:id` - Delete project\n\n### Tasks\n\n- `GET /api/projects/:id/tasks` - Get tasks for project\n- `POST /api/projects/:id/tasks` - Create new task\n- `PUT /api/tasks/:id` - Update task\n- `DELETE /api/tasks/:id` - Delete task\n\n### Chat\n\n- `GET /api/chats` - Get user's chat list\n- `POST /api/chats` - Create new chat\n- `GET /api/chats/:id/messages` - Get messages in chat\n- `POST /api/chats/:id/messages` - Send message to chat\n\n### Files\n\n- `POST /api/upload` - Upload file\n- `GET /api/files/:id` - Download file\n\n## 📝 Roadmap\n\n- [ ] **Q3 2025**\n\n  - Mobile application (React Native)\n  - Calendar integration\n  - Advanced analytics dashboard\n\n- [ ] **Q4 2025**\n\n  - AI-powered task recommendations\n  - Workflow automation tools\n  - Time tracking features\n\n- [ ] **Q1 2026**\n  - Extended API for third-party integrations\n  - Custom plugin system\n  - Enterprise-grade security features\n\n## 🤝 Contributing\n\nWe welcome contributions to Nomeda-TaskHub! Here's how you can help:\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\nPlease make sure to update tests as appropriate and adhere to our code of\nconduct.\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file\nfor details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdallah4z%2Fnomeda-taskhub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabdallah4z%2Fnomeda-taskhub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabdallah4z%2Fnomeda-taskhub/lists"}