An open-source search engine that aggregates content across categories — JAV, anime, movies, and comics, all in one place.
This repository contains both English and Chinese documentation.
English — this file is the English README. 中文（简体） — 查看中文 README
- Quick Access
- Project Documentation
- Project Features
- Technology Stack Overview
- Quick Start
- Performance Optimization
- Security Features
- License
- Acknowledgments
- Contact and Support
| Resource Type | Link | Remarks |
|---|---|---|
| Online Experience | https://atlas.wort.uk/ | Try out all features |
The project uses a modular documentation system, where each specialized documentation is maintained independently.
| Document | Description | Link |
|---|---|---|
| Configuration Documentation | Frontend configuration, backend configuration, environment variables, proxy services, database configuration, role permission configuration | docs/config.md |
| Deployment Guide | Environment requirements, local development, backend deployment, frontend deployment, database configuration, FAQ | docs/deploy.md |
| Version Changelog | Complete version change records: v2.0 (architecture reconstruction), v3.0 (security enhancement + feature expansion), v3.1 (monorepo sharing + security hardening + performance optimization), v4.0 (anime & movie search + architecture upgrade), v4.1 (comic search + architecture optimization) | docs/CHANGELOG.md |
| GitHub Push Guide | Git operation process, submission specifications, branch management, GitHub Actions automatic deployment configuration | docs/github_push.md |
| Document | Description | Link |
|---|---|---|
| Notification Component Documentation | Toast notification component usage, API documentation, configuration options, and best practices | frontend/docs/notification.md |
- JAV Search: Aggregates metadata from DMM/FANZA and searches magnets from JavBus/JavDB
- Anime Search: Aggregates data from Bangumi, Mikan, Nyaa, and ShowRSS, including subtitles and magnet links
- Movie Search: Aggregates metadata from TMDB, YTS, EZTV, and TPB, including seeds and magnets
- Comic Search: Aggregates metadata from MangaDex and 13 other search sources
- Unified Experience: All four categories are accessible from a single entry, with search results aggregated from multiple sources
- React 19 + TypeScript: Utilizes the latest React features with complete type safety provided by TypeScript
- Vite Ultra-fast Build: Millisecond-level hot updates and a silky smooth development experience
- Tailwind CSS: An atomic CSS solution that supports seamless switching between light and dark themes
- Zustand State Management: A lightweight state management solution with automatic persistent storage
- Cloudflare Full-Stack Deployment: Utilizes Cloudflare Pages for frontend, Workers for backend, and D1 for database, all in a fully serverless architecture
- Global CDN Acceleration: Leverages Cloudflare's 300+ global edge nodes for user-proximity access
- Zero Operational Costs: No need to purchase servers; the free tier can support small to medium-sized applications
- Automatic Elastic Scaling: Automatically scales during peak traffic, eliminating concerns about server crashes
- JWT Stateless Authentication: Token-based authentication implemented with the jose library, supporting automatic refresh
- Comprehensive Email Verification: Includes registration verification, password reset, email change, and account deletion, all with email confirmation
- Multi-Layer Security Mechanisms: Features login failure lock, verification code frequency limits, temporary email blacklists, and security event logs
- RBAC Permission System: Implements a four-level role permission system (Super Admin, Administrator, User, Guest) with fine-grained permission control
React 19 → Concurrent rendering, Suspense, automatic batching
TypeScript → Complete type inference, generic constraints, type guards
Vite → Native ESM support, on-demand compilation, ultra-fast HMR
Tailwind CSS → JIT compilation, dark mode, responsive design
Zustand → Ultra-simple API, middleware support, persistent storage
@codeseek/shared → Monorepo shared package (types, utilities, validation rules)
React Router → Data routing, lazy loading, nested layout
Lucide React → 1000+ beautiful icons, Tree-shaking optimization
date-fns → Lightweight date handling, internationalization support
Hono 4.x → Ultra-lightweight web framework with multi-runtime support
TypeScript → Type safety, interface definition, generic constraints
Cloudflare Workers → Edge computing, V8 isolation environment, zero cold start
Cloudflare D1 → SQLite-compatible, globally distributed, with automatic backup
JWT (jose) → Standardized authentication, support for multiple algorithms
Resend → Modern email service with high deliverability and real-time tracking
- Mobile-First: Perfectly adapts to all device sizes, from 320px to 4K monitors
- Touch Optimization: Supports gesture operations, sliding menus, and long-press interactions, providing a mobile experience comparable to native apps
- Performance Priority: First-screen load time under 1 second, interaction response time under 100ms, with a Lighthouse score of 90+
- Toast Notification System: Unified message prompts with four types: success, error, warning, and information
- Automatic Data Synchronization: Cross-device synchronization of search history, favorites, and personal settings
- Theme Customization: Supports light, dark, and system-following themes, with one-click switching and state persistence
- Shortcut Key Support: Common operations support keyboard shortcuts, improving operational efficiency
| Category | Data Source | Description |
|---|---|---|
| JAV | DMM/FANZA / JavBus / JavDB | Adult film metadata and magnet aggregation |
| Anime | Bangumi / Mikan / Nyaa / ShowRSS | Anime metadata, subtitle groups, and magnet links |
| Movie | TMDB / YTS / EZTV / TPB | Movie/TV series metadata and seed resources |
| Comic | MangaDex / 13 search sources | Comic metadata and resource aggregation |
Category (large category) Classification (subcategory) Source (source instance)
┌─────────────┐ ┌──────────────────┐ ┌──────────────┐
│ jav │ ────> │ metadata │ ────> │ DMM/FANZA │
│ │ │ magnet │ │ JavBus │
│ │ │ │ │ JavDB │
├─────────────┤ ├──────────────────┤ ├──────────────┤
│ anime │ ────> │ bangumi │ ────> │ Bangumi API │
│ │ │ mikan │ │ Mikan Project│
│ │ │ nyaa │ │ Nyaa.si │
│ │ │ showrss │ │ ShowRSS │
├─────────────┤ ├──────────────────┐ ├──────────────┤
│ movie │ ────> │ tmdb │ ────> │ TMDB API │
│ │ │ yts │ │ YTS │
│ │ │ eztv │ │ EZTV │
│ │ │ tpb │ │ TPB │
├─────────────┤ ├──────────────────┐ ├──────────────┤
│ manga │ ────> │ mangadex │ ────> │ MangaDex API │
│ │ │ sources │ │ 13 search sources │
└─────────────┘ └──────────────────┘ └──────────────┘
Core Design:
- Provider Registration Mode: Adding a new search category only requires creating a Provider class and registering one line in
backend/src/index.ts - Classification Independent Routing: Each classification has independent search logic and result panels
- Database-Driven Source Management: Enable/disable/weight of search sources managed through backend administration
- One-Click Aggregation: Select category and classification, input keyword, and display results from all sources
- Intelligent Sorting: Sort results based on search source priority, usage frequency, and availability status
- Classification Filtering: Support filtering by large category (JAV/Anime/Movie/Comic) and sub-classification
- Fixed Source Management: One-click fix common search sources for personalized customization (v4.1 new feature)
- History Record: Automatically save search history (with cover image), support quick re-search and history statistics
- Smart Prompt: Automatically prompt related search suggestions when typing a keyword
- Hot Search: Real-time display of hot search keywords, helping discover popular resources
- Search Statistics: Personal search statistics to understand search habits
- Enable/Disable: Free control which search sources participate in search
- Priority Adjustment: Customize search source display order
- Status Monitoring: Real-time view of search source availability
- Custom Addition: Support adding custom search sources (URL template)
- GitHub OAuth Login: One-click login with GitHub account, automatically creating/associating an account
- JWT Token Authentication: Stateless authentication with automatic token refresh support
- Login Protection: Automatically lock after 5 consecutive failed attempts for 15 minutes
- Session Management: View active sessions and support forced logout
- Favorites: Favorite commonly used search results (support all categories: JAV/Anime/Movie), with classification management
- Search History: Automatically record search history (with cover thumbnail), support clear and delete
- Data Sync: Cross-device synchronization of favorites, history, and settings
- Data Export: Support export personal data (JSON format)
- Share Search Sources: Share discovered useful search sources with the community
- Tag Management: Add tags to search sources for easy classification search
- Review Mechanism: Admin review required before listing to ensure quality
- Comment Rating: Publish reviews on search sources to help others choose
- Like/Favorite: Like quality search sources and collect them in personal list
- Report Mechanism: Report违规内容, with admin processing
- Personal Contribution: View number of shared search sources, download count, and rating
- Community Rankings: Hot shares and active contributor rankings
- Multiple Feedback Types: Problem feedback, optimization suggestions, others
- Anonymous Support: Unregistered users can also submit feedback
- Automatic Collection: Automatically record page URL and browser information
- Status Tracking: View feedback processing status (pending/waiting/solved/closed)
- Email Notification: Automatic email notification after feedback processing completed
- History Record: View own feedback history
- User List: Paginated query, search filtering, status view
- Role Permissions: Four-level roles (Super Admin, Administrator, User, Guest)
- Status Control: Enable/disable user accounts
- Login Logs: View user login records and IP information
- Search Source Management: CRUD system for search sources and classifications (support three major categories)
- Community Review: Review user-shared search sources
- Report Processing: Process user-reported content
- Dashboard: One-view system operation status and user activity
- Trend Analysis: User growth, search trends, activity changes
- Behavior Logs: User operation behavior record and analysis
- Configuration Management: Dynamic modification of system configuration without redeployment
- Coded Selection: JavBus homepage top 3 pages, random 20 entries
- Uncoded Selection: Uncoded area top 3 pages, random 20 entries
- HD Ranking: HD category top 3 pages, random 20 entries
- Subtitle Ranking: Subtitle category top 3 pages, random 20 entries
- Random Category: Random 10 categories, each category 12 entries
- Random Actress: Random 10 actresses, each actress 12 entries
- Number Suggestion: Input keyword to automatically match numbers
- Multi-Source Data: Support multi-source data aggregation display
- Login Required: Need user login authentication to access
┌─────────────────────────────────────────────────────────┐
│ Frontend Layer (v4.1.0) │
│ • React 19 + TypeScript │
│ • Vite Build Tool │
│ • Tailwind CSS Styling Framework │
│ • Zustand State Management │
│ • React Router Routing Management │
│ • AnimeSearchResultPanel / MovieSearchResultPanel │
│ • MangaSearchResultPanel (v4.1 new) │
│ • Deployment: Cloudflare Pages │
├─────────────────────────────────────────────────────────┤
│ Provider Layer (v4.1 Extended) │
│ • SearchProvider Interface + ProviderRegistry Registry │
│ • anime-provider (Bangumi/Mikan/Nyaa/ShowRSS) │
│ • movie-provider (TMDB/YTS/EZTV/TPB) │
│ • manga-provider (MangaDex/13 search sources) │
│ • jav-provider (Metadata/Magnet) │
├─────────────────────────────────────────────────────────┤
│ Backend Service Layer (v4.1.0) │
│ • Hono Framework (Ultra-lightweight Web Framework) │
│ • TypeScript Type Safety │
│ • Cloudflare Workers (Edge Computing) │
│ • Cloudflare D1 (SQLite Database) │
│ • JWT Token Authentication (jose) │
│ • Resend Email Service │
└─────────────────────────────────────────────────────────┘
See Complete Architecture Design
- Node.js: >= 18.0.0
- pnpm: >= 8.0.0
- Cloudflare Account: For deploying Workers and D1 database
- Wrangler CLI: Cloudflare development tool (>= 3.x)
# Clone project
git clone https://github.com/Zoroaaa/Atlas.git
cd Atlas
# Install dependencies
pnpm install
# Initialize database (including v4.1 new anime/movie/comic search sources)
npx wrangler d1 create atlas-db
npx wrangler d1 execute atlas-db --file=database/schema.sql
npx wrangler d1 execute atlas-db --file=database/06_data_search_sources.sql
npx wrangler d1 execute atlas-db --file=database/13_schema_history_cover.sql
npx wrangler d1 execute atlas-db --file=database/14_index_manga_optimization.sql
# Local development
pnpm dev
# Production deployment
pnpm build && cd backend && npx wrangler deploySee Detailed Deployment Guide See Configuration Instructions See Complete API Documentation See v4.1 Changelog
- React 19 concurrency features + Vite fast build
- Code splitting, route-level lazy loading, tree-shaking
- Zustand persistent state + API response cache
- React.memo and useMemo optimization to reduce re-rendering
- Cloudflare global edge nodes for near-source processing
- Database index optimization + parameterized queries
- Response compression (gzip/brotli) + batch operation support
- Request throttling + concurrency control + degradation strategies
- XSS protection + CSRF protection
- Content Security Policy (CSP) + Subresource Integrity (SRI)
- JWT Token authentication + request signature verification
- JWT Token authentication (jose library) + RBAC permission control
- SQL injection protection + password encryption storage (bcrypt)
- Login failure locking mechanism + security event logs
- CORS configuration + rate limiting + IP recording
This project is licensed under the MIT License.
You are free to:
- Use - for any purpose, including commercial use
- Modify - modify the source code to suit your needs
- Distribute - share the project or its modifications
- Private Use - use in private projects
But you must:
- Retain Copyright Notices - keep original copyright notices and license text
- State Modifications - indicate changes made to the source code
- Cloudflare - providing an excellent edge computing platform
- GitHub - code hosting and collaboration platform
- Resend - email sending service
Thanks to all developers who contribute to the open source community!
- Project Homepage: GitHub - Atlas
- Issue Reporting: GitHub Issues
- Feature Suggestions: GitHub Discussions
We welcome all forms of contributions:
- Report Bugs
- Propose New Features
- Improve Documentation
- Submit Code
- Translate Documentation
- Fork this repository
- Create a feature branch (
git checkout -b feature/AmazingFeature) - Commit changes (
git commit -m 'Add some AmazingFeature') - Push to branch (
git push origin feature/AmazingFeature) - Open a Pull Request
JAV / Anime / Movies / Comics, one-stop search
Made with ❤️ by Zoro