A modern, full-stack manga reading platform built with Next.js, TypeScript, and a comprehensive monorepo architecture. Taiyō provides a seamless experience for discovering, reading, and managing manga, manhwa, manhua, and light novels.
- Multi-format Support: Manga, Manhwa, Manhua, and Light Novels
- Multi-language Support: Official support for Portuguese and French, with technical capability for 100+ languages
- Advanced Search: Powered by Meilisearch for fast, relevant results
- User Management: Complete authentication system with Better Auth
- Content Rating System: Flexible content filtering (Normal, Suggestive, NSFW, NSFL)
- Real-time Updates: Latest releases and trending content
- Responsive Design: Optimized for desktop and mobile devices
- Dark/Light Theme: User preference-based theming
- Advanced customizations: Page-by-page, brightness, horizontal/vertical, and more
- Chapter Management: Upload, organize, and read chapters with page-by-page navigation
- Group Management: Scanlation group support with role-based permissions
- Logs: Comprehensive logging system with ClickHouse
- Monitoring: Real-time monitoring with Grafana
- Analytics: Comprehensive analytics and performance monitoring with PostHog
This project uses a monorepo architecture powered by Turborepo and pnpm workspaces.
taiyo/
├── apps/ # Applications
│ ├── web/ # Next.js web application
│ ├── io-worker/ # Background job processor
│ └── storybook/ # Component documentation
├── packages/ # Shared packages
│ ├── auth/ # Authentication utilities
│ ├── cache/ # Caching layer
│ ├── config/ # Shared configuration
│ ├── db/ # Database layer
│ ├── email/ # Email templates and utilities
│ ├── global-types/ # Global TypeScript types
│ ├── logs/ # Logging layer
│ ├── meilisearch/ # Search engine integration
│ ├── messages/ # Internationalization message files
│ ├── messaging/ # Message queue utilities
│ ├── s3/ # File storage utilities
│ ├── schemas/ # Zod validation schemas
│ ├── trpc/ # tRPC API layer
│ ├── types/ # TypeScript types
│ └── utils/ # Shared utilities
└── tooling/ # Development tools
├── github/ # GitHub Actions
├── tailwind/ # Tailwind CSS configuration
└── typescript/ # TypeScript configuration
Frontend:
- Next.js 15 with App Router
- React 19
- TypeScript
- Tailwind CSS 4
- Base UI for accessible components
- Framer Motion for animations
- Next Intl for internationalization
- PostHog for analytics
Backend:
- tRPC for type-safe APIs
- Prisma as ORM
- Better Auth for authentication
- BullMQ for job queues
- Zod for schema validation
- ClickHouse for logging
Infrastructure:
- PostgreSQL - Primary database
- Meilisearch - Search engine
- Dragonfly - Redis-compatible cache
- ClickHouse - Analytics database
- S3-compatible storage - File storage
- Node.js: 22.x.x (specified in
.nvmrc) - pnpm: 10.x.x (specified in
package.json) - Docker & Docker Compose: For local infrastructure
-
Clone the repository
git clone https://github.com/taiyomoe/taiyo.git cd taiyo -
Install dependencies
pnpm install
-
Set up environment variables
cp .env.example .env.local # Edit .env.local with your configuration -
Start infrastructure services
docker-compose up -d
-
Run database migrations
pnpm -F @taiyomoe/db run migrate
-
Start development servers
pnpm dev
The application will be available at:
- Web App: http://localhost:3000
- Storybook: http://localhost:6006
# Development
pnpm dev # Start all apps in development mode
pnpm build # Build all packages and apps
pnpm typecheck # Run TypeScript type checking
pnpm clean # Clean all node_modules
pnpm clean:ws # Clean workspace build artifacts
# Code Quality
pnpm check:ws # Run Biome linting and formatting
pnpm lint:ws # Run Sherif for dependency validation
pnpm knip # Check for unused dependencies# Database
pnpm -F @taiyomoe/db run db migrate # Run database migrations
pnpm -F @taiyomoe/db run seed # Seed database with sample data
# Web Application
pnpm -F @taiyomoe/web run dev # Start web app in dev mode
pnpm -F @taiyomoe/web run build # Build web app for production
pnpm -F @taiyomoe/web run start # Start production web app
# Storybook
pnpm -F @taiyomoe/storybook run dev # Start Storybook dev server
pnpm -F @taiyomoe/storybook run build-storybook # Build static Storybook
# IO Worker
pnpm -F @taiyomoe/io-worker run start # Start background job processorThis project uses git-flow for branch management:
main- Production-ready codedevelop- Integration branch for featuresfeature/*- Feature development brancheshotfix/*- Critical production fixesrelease/*- Release preparation branches
- Linting: Biome for fast linting and formatting
- Type Checking: TypeScript with strict configuration
- Dependency Validation: Sherif for workspace consistency
- Unused Code Detection: Knip for finding unused dependencies
- Workspace Dependencies: Use
workspace:^for internal packages - Version Management: All packages use semantic versioning
- Dependency Installation: Always use
pnpm(not npm or yarn)
The are 30+ environment variables that are used in the project. You can find them in the .env.example file.
@taiyomoe/db: Database layer with Prisma ORM, migrations, and data models@taiyomoe/auth: Authentication system with Better Auth integration@taiyomoe/trpc: Type-safe API layer with tRPC@taiyomoe/schemas: Zod validation schemas for data validation@taiyomoe/utils: Shared utility functions and helpers
@taiyomoe/cache: Caching layer with Dragonfly integration@taiyomoe/meilisearch: Search engine integration@taiyomoe/s3: File storage utilities@taiyomoe/email: Email templates and sending utilities@taiyomoe/messaging: Message queue utilities
@taiyomoe/config: Shared configuration and constants@taiyomoe/types: Global TypeScript type definitions@taiyomoe/messages: Internationalization message files
# Build all packages and applications
pnpm build
# Start production servers
pnpm -F @taiyomoe/web run start
pnpm -F @taiyomoe/io-worker run start# Build and start all services
docker-compose -f docker-compose.prod.yml up -d- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Run tests and linting (
pnpm check:ws) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow the existing code style and patterns
- Write meaningful commit messages
- Add tests for new features
- Update documentation as needed
- Ensure all checks pass before submitting PRs
This project is licensed under the MIT License - see the LICENSE file for details.
- MangaDex for UI inspiration and manga data
Taiyō - Bringing manga to life with modern technology 🌅