A comprehensive Genshin Impact hub — browse characters & weapons, plan farming schedules,
build tier lists, and challenge yourself with Genshin mini-games.
| Feature | Description | |
|---|---|---|
| 🧙 | Character Database | Full profiles — talents, constellations, passives, and ascension paths |
| ⚔️ | Weapon Catalog | Complete stats, refinements, and material farming routes |
| 📅 | Farming Calendar | Daily talent-book and weapon-material schedule by day of week |
| 🏆 | Tier List Builder | Drag-and-drop tier list creator with shareable layouts |
| 🎮 | Genshindle | Wordle-style character guessing game |
| 🃏 | Memory Game | Card-matching game with Genshin character art |
| 🔗 | Linker Game | Connect characters by shared traits |
| 📋 | Routine Planner | Build and track your daily resin & farming routine |
|
Weapon Detail |
Character Talents |
|
Character Attacks |
Constellations |
|
Talent Farming Calendar |
Weapon Farming Calendar |
|
Tier List Builder |
Routine Planner |
- Bun — fast all-in-one JavaScript runtime & package manager
# Clone the repo
git clone https://github.com/utkarsh5026/GenshinQL.git
cd GenshinQL/client
# Install dependencies
bun install
# Start dev server → http://localhost:5173
bun run dev| Layer | Technology |
|---|---|
| UI | React 18 · React Router v7 · Framer Motion 12 |
| Language | TypeScript 5.9 (strict mode) |
| Build | Vite 7 · Bun |
| State | Zustand 5 |
| Styling | Tailwind CSS 4 · shadcn/ui · Radix UI |
| Data | Static JSON · IndexedDB (stale-while-revalidate cache) · Selenium scrapers |
| Infra | Cloudflare R2 (media CDN) · Vercel (hosting) |
No backend. All data is served from static JSON files under
client/public/and cached client-side in IndexedDB.
# Development
bun run dev # Start Vite dev server (localhost:5173)
bun run build # Type-check + production build
bun run preview # Preview production build locally
# Code quality
bun run validate # lint + format:check + tsc --noEmit (run before pushing)
bun run lint:fix # Auto-fix ESLint issues
bun run format # Format code with Prettier
# Analysis
bun run build:analyze # Bundle size visualizerbun run scrape:all # Scrape all game data
bun run scrape:characters # Characters only
bun run scrape:weapons # Weapons only
bun run scrape:talents # Talent schedules only
bun run scrape:gallery # Character gallery media only
bun run consolidate # Merge scraped data into JSON files
bun run generate-primitives # Regenerate game constantsContributions are welcome! Please check the Development Guide for architecture details.
- Fork the repository
- Create a feature branch —
git checkout -b feat/amazing-feature - Make your changes and run
bun run validate - Commit using Conventional Commits —
feat: add amazing feature - Push and open a Pull Request
- Enka Network integration for live player data
- Character build guides and team composition recommendations
- Artifact, material, and boss-drop reference with build suggestions
- Advanced character build calculator
- Team composition optimizer
Licensed under the MIT License.
Made with ❤️ for the Genshin Impact community
