{"id":31104770,"url":"https://github.com/serverless-operations/todo-app-using-spec-kit","last_synced_at":"2025-09-17T03:48:52.053Z","repository":{"id":314313305,"uuid":"1054964667","full_name":"serverless-operations/todo-app-using-spec-kit","owner":"serverless-operations","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-11T17:36:59.000Z","size":80,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-11T20:16:53.061Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/serverless-operations.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-11T15:15:10.000Z","updated_at":"2025-09-11T17:37:02.000Z","dependencies_parsed_at":"2025-09-11T20:18:50.928Z","dependency_job_id":"0a48d2d8-d285-4d7d-8419-e9defb5713e9","html_url":"https://github.com/serverless-operations/todo-app-using-spec-kit","commit_stats":null,"previous_names":["serverless-operations/todo-app-using-spec-kit"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/serverless-operations/todo-app-using-spec-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-operations%2Ftodo-app-using-spec-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-operations%2Ftodo-app-using-spec-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-operations%2Ftodo-app-using-spec-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-operations%2Ftodo-app-using-spec-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serverless-operations","download_url":"https://codeload.github.com/serverless-operations/todo-app-using-spec-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverless-operations%2Ftodo-app-using-spec-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275531427,"owners_count":25481325,"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","status":"online","status_checked_at":"2025-09-17T02:00:09.119Z","response_time":84,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-09-17T03:48:49.783Z","updated_at":"2025-09-17T03:48:52.043Z","avatar_url":"https://github.com/serverless-operations.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TODO Task Management System\n\nA full-stack task management application with Japanese language support, built with TypeScript, React, and Express.js.\n\n## Features\n\n- ✅ Create, read, update, and delete tasks\n- 📅 Set deadlines for tasks\n- ⚠️ Visual warnings for approaching and overdue deadlines\n- ✓ Mark tasks as completed\n- 🇯🇵 Japanese date formatting (YYYY年MM月DD日 HH:mm)\n- 📱 Responsive web interface\n- 🚀 Real-time updates with React Query\n\n### Deadline Warnings\n- **Yellow highlight**: Tasks due within 3 days (期限が近づいています)\n- **Red highlight**: Overdue tasks (期限を過ぎています)\n\n## Tech Stack\n\n### Backend\n- Node.js 22\n- Express.js 5\n- TypeScript\n- SQLite3 (better-sqlite3)\n- Zod for validation\n- Winston for logging\n\n### Frontend\n- React 19\n- TypeScript\n- React Router v7\n- React Query (TanStack Query)\n- Vite\n- Axios\n\n## Prerequisites\n\n- Node.js 22.x or higher\n- npm 11.x or higher\n\n## Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/serverless-operations/todo-app-using-spec-kit.git\ncd todo-app\n```\n\n2. Install dependencies:\n```bash\n# Install all dependencies (root, backend, and frontend)\nnpm run install:all\n```\n\n## Development\n\n### Run both backend and frontend:\n```bash\nnpm run dev\n```\n\nThis will start:\n- Backend API server on http://localhost:4000\n- Frontend dev server on http://localhost:5173\n\n### Run services individually:\n\nBackend only:\n```bash\nnpm run dev:backend\n```\n\nFrontend only:\n```bash\nnpm run dev:frontend\n```\n\n## Building for Production\n\n```bash\n# Build both backend and frontend\nnpm run build\n\n# Start production server\nnpm run start\n```\n\n## Testing\n\n### Run all tests:\n```bash\nnpm run test\n```\n\n### Run backend tests:\n```bash\nnpm run test:backend\n```\n\n### Run frontend tests:\n```bash\nnpm run test:frontend\n```\n\n### Test Coverage:\n```bash\ncd backend \u0026\u0026 npm run test:coverage\ncd frontend \u0026\u0026 npm run test:coverage\n```\n\n## Project Structure\n\n```\ntodo-app/\n├── backend/\n│   ├── src/\n│   │   ├── db/           # Database initialization\n│   │   ├── middleware/   # Express middleware\n│   │   ├── models/       # Data models and validation\n│   │   ├── routes/       # API routes\n│   │   ├── services/     # Business logic\n│   │   ├── types/        # TypeScript types\n│   │   └── utils/        # Utility functions\n│   ├── tests/\n│   │   ├── contract/     # API contract tests\n│   │   ├── integration/  # Integration tests\n│   │   └── unit/        # Unit tests\n│   └── data/            # SQLite database file\n├── frontend/\n│   ├── src/\n│   │   ├── components/  # React components\n│   │   ├── hooks/       # Custom React hooks\n│   │   ├── pages/       # Page components\n│   │   ├── providers/   # Context providers\n│   │   ├── services/    # API services\n│   │   └── types/       # TypeScript types\n│   └── tests/          # Frontend tests\n├── docs/               # Documentation\n└── specs/             # Specifications\n\n```\n\n## API Documentation\n\nSee [docs/api.md](docs/api.md) for detailed API documentation.\n\n### Quick API Reference\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| GET | `/api/tasks` | Get all active tasks |\n| GET | `/api/tasks/completed` | Get completed tasks |\n| GET | `/api/tasks/:id` | Get task by ID |\n| POST | `/api/tasks` | Create new task |\n| PUT | `/api/tasks/:id` | Update task |\n| DELETE | `/api/tasks/:id` | Delete task |\n| PATCH | `/api/tasks/:id/complete` | Mark task as complete |\n\n## Environment Variables\n\n### Backend (.env)\n```\nPORT=4000\nFRONTEND_URL=http://localhost:5173\n```\n\n### Frontend (.env)\n```\nVITE_API_URL=http://localhost:4000\n```\n\n## Database\n\nThe application uses SQLite for data persistence. The database file is automatically created at `backend/data/tasks.db` on first run.\n\n### Database Schema\n\n```sql\nCREATE TABLE tasks (\n  id TEXT PRIMARY KEY,\n  content TEXT NOT NULL,\n  deadline TEXT NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  completed_at TEXT\n)\n```\n\n## Scripts\n\n### Root package.json\n- `npm run dev` - Run both backend and frontend in development mode\n- `npm run build` - Build both backend and frontend\n- `npm run start` - Start production server\n- `npm run test` - Run all tests\n- `npm run install:all` - Install all dependencies\n\n### Backend Scripts\n- `npm run dev` - Start development server with hot reload\n- `npm run build` - Compile TypeScript to JavaScript\n- `npm run start` - Start production server\n- `npm run test` - Run tests\n- `npm run db:init` - Initialize database\n\n### Frontend Scripts\n- `npm run dev` - Start Vite dev server\n- `npm run build` - Build for production\n- `npm run preview` - Preview production build\n- `npm run lint` - Run ESLint\n\n## Contributing\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.\n\n## Acknowledgments\n\nBuilt with [Spec-Driven Development](https://github.com/serverless-operations/spec-kit) methodology.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserverless-operations%2Ftodo-app-using-spec-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserverless-operations%2Ftodo-app-using-spec-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserverless-operations%2Ftodo-app-using-spec-kit/lists"}