{"id":40717449,"url":"https://github.com/brickgale/manga-reader","last_synced_at":"2026-04-18T04:05:30.484Z","repository":{"id":331797116,"uuid":"1130277302","full_name":"brickgale/manga-reader","owner":"brickgale","description":"📖 Offline Manga Reader","archived":false,"fork":false,"pushed_at":"2026-04-13T13:46:59.000Z","size":2684,"stargazers_count":4,"open_issues_count":11,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-13T14:07:17.777Z","etag":null,"topics":["docker","express","manga","manga-reader","prisma","sqlite","typescript","vite","vue","webtoon"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/brickgale.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-08T09:25:45.000Z","updated_at":"2026-04-13T12:09:02.000Z","dependencies_parsed_at":"2026-03-17T11:08:11.841Z","dependency_job_id":null,"html_url":"https://github.com/brickgale/manga-reader","commit_stats":null,"previous_names":["brickgale/manga-reader"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/brickgale/manga-reader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickgale%2Fmanga-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickgale%2Fmanga-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickgale%2Fmanga-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickgale%2Fmanga-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brickgale","download_url":"https://codeload.github.com/brickgale/manga-reader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brickgale%2Fmanga-reader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31955920,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"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":["docker","express","manga","manga-reader","prisma","sqlite","typescript","vite","vue","webtoon"],"created_at":"2026-01-21T13:30:49.048Z","updated_at":"2026-04-18T04:05:30.478Z","avatar_url":"https://github.com/brickgale.png","language":"TypeScript","readme":"# Manga Reader\n\nA simple manga/manhwa reader application with reading history, bookmarks, and progress tracking.\n\n![Manga Reader Preview](/frontend/public/images/preview-mangareader.png)\n\n## Features\n\n- 📁 Browse and scan local manga directories\n- 🔍 Search manga by title with debounced search\n- 📖 Read manga with page navigation\n- 📚 Reading history tracking\n- 🔖 Page bookmarks\n- 📊 Progress tracking\n- 🎨 Dark/Light theme support\n\n## Requirements\n\n- Docker \u0026 Docker Compose\n- Your manga files in a directory (default: `/mnt/d/Manhwa`)\n\n## Quick Start\n\n1. **Clone the repository**\n\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd manga-reader\n   ```\n\n2. **Configure manga storage path**\n\n   Create `.env` file from the example:\n\n   ```bash\n   cp .env.example .env\n   ```\n\n   Edit `.env` and set your manga directory:\n\n   ```bash\n   MANGA_STORAGE_PATH=/path/to/your/manga\n   ```\n\n   Default is `/mnt/d/Manhwa`\n\n3. **Build and start**\n\n   ```bash\n   docker compose build\n   docker compose up -d\n   ```\n\n4. **Access the application**\n\n   Open your browser: `http://localhost:3000`\n\n## Usage\n\n1. Click \"Scan Directory\" button on the home page\n2. The input will be pre-filled with `/manga` (your mounted storage path)\n3. Click \"Scan\" to import your manga\n4. Start reading!\n\n## Stopping the Application\n\n```bash\ndocker compose down\n```\n\n## Development\n\n### Version Management\n\nThe application version is displayed in the Settings drawer. To update the version:\n\n**Option 1: Using the sync script (recommended)**\n\n```bash\n# Sync frontend to match backend version\nnode sync-version.js\n\n# Update both to a new version\nnode sync-version.js 1.2.0\n```\n\n**Option 2: Manual update**\n\n1. Update `backend/package.json` version\n2. Update `frontend/package.json` version (must match)\n3. Rebuild and restart the backend:\n   ```bash\n   docker compose build backend\n   docker compose up -d backend\n   ```\n\n**Version validation:**\n\n- Backend validates version sync at startup (when frontend package.json is accessible)\n- If versions don't match, a warning is logged to help catch inconsistencies\n- The backend version is considered the source of truth\n- In Docker, validation may not run since frontend/backend are separate containers\n\n## Tech Stack\n\n- **Backend**: Node.js, Express, Prisma, SQLite\n- **Frontend**: Vue 3, Vite, Tailwind CSS\n- **Infrastructure**: Docker, Docker Compose\n\n## Project Structure\n\n```\nmanga-reader/\n├── backend/          # Backend API server\n├── frontend/         # Vue frontend application\n├── storage/          # Data storage (covers, etc.)\n│   └── images/       # Downloaded cover images\n├── docker-compose.yml\n└── README.md\n```\n\nFor detailed information about the backend or frontend, see their respective README files:\n\n- [Backend Documentation](./backend/README.md)\n- [Frontend Documentation](./frontend/README.md)\n- [Nginx Documentation](./docker/nginx/README.md)\n\n## License\n\nMIT\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrickgale%2Fmanga-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrickgale%2Fmanga-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrickgale%2Fmanga-reader/lists"}