🌍 GalWorld

The Ultimate Galgame & Visual Novel Portal

Comprehensive platform featuring 25,000+ titles, with rating system, walkthroughs, resources, and community all in one place.

🚀 Quick Start · ✨ Features · 📦 Architecture · 🤝 Contributing

---

中文说明 | English

✨ Features

🎮 Seven Core Modules

Module	Status	Description
Game Library System	✅ Complete	25,463 title database, multi-level filtering, multi-dimensional rating system
Navigation Center	✅ Complete	Four-dimensional classification: Era / Developer / Genre / Tier
Resource Center	🚧 In Development	Game mirrors, save files, artwork, tools & patches
News Center	🚧 In Development	New release announcements, industry news, editorials
Wiki & Strategy	🚧 In Development	Walkthroughs, character database, world lore
Community Forum	🚧 In Development	General discussion, reviews, fan translations
User Center	🚧 In Development	Favorites, progress tracking, achievements, recommendations

💎 Tech Highlights

• 🍰 Modern UI Design - Glassmorphism effects, elegant animations, unified design language
• 📱 Fully Responsive - Pixel-perfect on mobile, tablet, and desktop
• ⚡ Blazing Fast - Vite powered, on-demand loading, instant responsiveness
• 🎯 TypeScript Ready - Complete type system for robust code
• 🔍 Advanced Search - Multi-dimensional combinatorial filtering
• 📊 Data Visualization - Radar charts for multi-axial ratings, heatmap analytics

🏗️ Architecture

GalWorld/
├── 📁 src/
│   ├── 📁 modules/              # 7 Core Feature Modules
│   │   ├── 🎮 games/           # Game Library System
│   │   │   ├── GamesHall.vue   # Discovery Hall
│   │   │   ├── CategoryList.vue# Multi-level Navigation
│   │   │   ├── GameDetail.vue  # Game Detail Page
│   │   │   └── Rankings.vue    # Leaderboards
│   │   ├── 🧭 navigation/      # Navigation Center
│   │   ├── 📚 resource/        # Resource Center
│   │   ├── 📰 news/            # News Center
│   │   ├── 📖 wiki/            # Wiki & Strategy
│   │   ├── 💬 community/       # Community
│   │   └── 👤 user/            # User Center
│   ├── 📁 components/          # Shared Components
│   ├── 📁 data/                # Data Structures
│   ├── 📁 stores/              # State Management
│   └── router.ts               # Route Configuration
├── 📄 package.json             # Project Config
├── 📄 tailwind.config.js       # Styling Config
└── 📄 vite.config.ts           # Build System

🚀 Quick Start

Requirements

• Node.js >= 20.0
• npm >= 9.0 or pnpm >= 8.0

Local Development

# 1. Clone the project
git clone https://github.com/badhope/galworld.git
cd galworld

# 2. Install dependencies
npm install

# 3. Start dev server
npm run dev

# 4. Visit http://localhost:5173

Production Build

# Build for production
npm run build

# Preview production build
npm run preview

📊 Project Status

✅ Completed

• Game database schema (25,463 titles)
• Quad-level classification system (Era / Developer / Genre / Tier)
• Multi-dimensional scoring system with radar charts
• Game detail page with 5 major modules
• Full page skeleton and navigation for all modules
• Unified UI design language and animations
• Full responsive mobile support
• Advanced search component

🚧 In Development

• Full crawler data integration
• Resource download system
• User reviews and ratings
• Wiki editing system
• Forum functionality
• User authentication system
• Internationalization (i18n)

🤝 Contributing

Community contributions are highly welcome!

How to Contribute

1. 🍴 Fork this repository
2. 🔧 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit your changes (git commit -m 'feat: add some amazing feature')
4. 📤 Push to the branch (git push origin feature/AmazingFeature)
5. 🔍 Open a Pull Request

Commit Guidelines

Please follow Conventional Commits:

feat: New feature
fix: Bug fix
docs: Documentation update
style: Code style adjustment
refactor: Code refactoring
test: Testing related
chore: Build / tooling related

Code Standards

TypeScript

• Ensure all types are properly defined
• Avoid any type
• Use type inference

Vue

• Use Composition API
• PascalCase for component names
• Props must have type definitions

CSS

• Use Tailwind CSS utility classes
• Maintain responsive design
• Follow existing design patterns

📄 License

This project is licensed under the MIT License.

⚠️ IMPORTANT: Commercial use REQUIRES written approval from the project owner.

All game data, images, and resources within this project are for educational purposes only.

💝 Support This Project

If you find this project helpful:

• ⭐ Give it a Star
• 🔗 Share it with friends
• 💬 Provide feedback and bug reports
• 🌟 Contribute code to the project

---

GalWorld Team © 2026

Built with ❤️ for the Visual Novel Community