{"id":28167213,"url":"https://github.com/dhrypt/supreme-pancake","last_synced_at":"2025-08-04T20:09:35.952Z","repository":{"id":290608076,"uuid":"974906344","full_name":"dhrypt/supreme-pancake","owner":"dhrypt","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-29T17:25:11.000Z","size":50,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-29T18:20:05.578Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dhrypt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null}},"created_at":"2025-04-29T13:37:46.000Z","updated_at":"2025-04-29T17:25:14.000Z","dependencies_parsed_at":"2025-04-29T18:20:17.048Z","dependency_job_id":null,"html_url":"https://github.com/dhrypt/supreme-pancake","commit_stats":null,"previous_names":["dhrypt/supreme-pancake"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhrypt%2Fsupreme-pancake","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhrypt%2Fsupreme-pancake/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhrypt%2Fsupreme-pancake/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dhrypt%2Fsupreme-pancake/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dhrypt","download_url":"https://codeload.github.com/dhrypt/supreme-pancake/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254355409,"owners_count":22057356,"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":[],"created_at":"2025-05-15T14:12:06.476Z","updated_at":"2025-05-15T14:12:20.142Z","avatar_url":"https://github.com/dhrypt.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# supreme-pancake\n\nA full-stack task management application built with React, Express, MongoDB, and Docker.\n\n## Features\n\n- User registration and login with JWT authentication\n- Create, view, update, and delete tasks\n- Filter tasks by status (All, Active, Completed)\n- Task attributes: title, description, status, priority, creation date, user ID\n- Responsive UI with Tailwind CSS\n- Dockerized for easy setup\n\n## Tech Stack\n\n- **Frontend**: React 19, React Router, Tailwind CSS, Vite\n- **Backend**: Express, MongoDB, Mongoose, JWT, bcrypt\n- **DevOps**: Docker, Docker Compose\n- **State Management**: React Context for auth, local state for tasks\n- **Custom Hook**: `useAuth` for authentication\n\n## Architecture\n\n- **Frontend**: Single-page React app with routes for login, register, and tasks. Uses Context API for auth state and a custom hook for auth operations.\n- **Backend**: RESTful API with endpoints for auth (`/api/auth`) and tasks (`/api/tasks`). Secured with JWT.\n- **Database**: MongoDB with schemas for users (email, password) and tasks (title, description, status, priority, userId, createdAt).\n- **Docker**: Three services (frontend, backend, MongoDB) connected via a bridge network.\n\n## Database Schema\n\n### User\n\n```javascript\n{\n  email: String (required, unique, lowercase),\n  password: String (required, hashed),\n  createdAt: Date,\n  updatedAt: Date\n}\n```\n\n### Task\n\n```javascript\n{\n  title: String (required),\n  description: String,\n  status: String (enum: ['incomplete', 'complete'], default: 'incomplete'),\n  priority: String (enum: ['Low', 'Medium', 'High'], default: 'Low'),\n  userId: ObjectId (ref: 'User', required),\n  createdAt: Date,\n  updatedAt: Date\n}\n```\n\n## Setup Instructions\n\n### Prerequisites\n\n- Docker and Docker Compose\n- Node.js (optional for local development without Docker)\n\n### Running with Docker\n\n1. Clone the repository:\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd task-management\n   ```\n2. Create a `.env` file in `task-management-backend` with:\n   ```env\n   PORT=5001\n   MONGODB_URI=mongodb://admin:admin123@mongodb:27017/taskdb?authSource=admin\n   JWT_SECRET=your_jwt_secret_key_123\n   ```\n3. Start the services:\n   ```bash\n   docker-compose up --build\n   ```\n4. Access the app:\n   - Frontend: `http://localhost:5173`\n   - Backend API: `http://localhost:5001/api`\n5. Seed the database with test data:\n   ```bash\n   docker-compose exec backend node seed.js\n   ```\n\n### Running Locally\n\n1. **Backend**:\n   ```bash\n   cd task-management-backend\n   npm install\n   node seed.js\n   npm start\n   ```\n2. **Frontend**:\n   ```bash\n   cd task-management-frontend\n   npm install\n   npm run dev\n   ```\n\n### Test Users\n\n- User 1: `user1@example.com` / `password1`\n- User 2: `user2@example.com` / `password2`\n\n## Technical Choices\n\n- **React with Vite**: Fast development and build times.\n- **Tailwind CSS**: Utility-first CSS for rapid UI development.\n- **JWT Authentication**: Secure and stateless auth mechanism.\n- **MongoDB**: Flexible NoSQL database for rapid prototyping.\n- **Docker Compose**: Simplifies multi-container setup and ensures consistency.\n- **Context API**: Lightweight state management for auth.\n- **Custom Hook**: Encapsulates auth logic for reusability.\n\n## Notes\n\n- The backend runs on port 5001 to avoid conflicts on macOS.\n- Error handling is implemented for API requests and user input.\n- PropTypes are used for prop validation in React components.\n- Seed script provides sample data for testing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhrypt%2Fsupreme-pancake","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdhrypt%2Fsupreme-pancake","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdhrypt%2Fsupreme-pancake/lists"}