|
|
# Ultimate Gaming 🎮 |
|
|
|
|
|
A web-based platform for hosting trivia game shows, featuring **Kuldvillak** (Estonian Jeopardy). |
|
|
|
|
|
## Features |
|
|
|
|
|
- ✨ **Game Editor** - Create custom games with categories, questions, and daily doubles |
|
|
- 🖥️ **Dual-Screen Setup** - Moderator controls + Projector display |
|
|
- 🔄 **Real-time Sync** - Cross-tab synchronization via BroadcastChannel API |
|
|
- 🎨 **Theme Customization** - Customize colors to match your brand |
|
|
- 🌍 **Internationalization** - Estonian and English support |
|
|
- 💾 **Persistent Storage** - Auto-save and load games from localStorage |
|
|
|
|
|
## Tech Stack |
|
|
|
|
|
- **SvelteKit 2** + **Svelte 5** (Runes) |
|
|
- **TailwindCSS 4** for styling |
|
|
- **TypeScript** for type safety |
|
|
- **Paraglide** for i18n |
|
|
|
|
|
## Getting Started |
|
|
|
|
|
```bash |
|
|
# Install dependencies |
|
|
npm install |
|
|
|
|
|
# Start development server |
|
|
npm run dev |
|
|
|
|
|
# Open in browser |
|
|
npm run dev -- --open |
|
|
``` |
|
|
|
|
|
## Usage |
|
|
|
|
|
1. **Create a Game**: Go to `/kuldvillak/edit` to create a new game |
|
|
2. **Add Teams**: Configure 2-6 players/teams |
|
|
3. **Fill Content**: Add categories, questions, and answers |
|
|
4. **Start Playing**: Click "Start" to launch the game |
|
|
5. **Open Projector**: Use "Open Projector" button for display screen |
|
|
|
|
|
## Project Structure |
|
|
|
|
|
``` |
|
|
src/ |
|
|
├── lib/ |
|
|
│ ├── components/ # Reusable UI components |
|
|
│ ├── stores/ # Svelte stores (gameSession, theme, audio) |
|
|
│ └── types/ # TypeScript interfaces |
|
|
├── routes/ |
|
|
│ ├── kuldvillak/ |
|
|
│ │ ├── edit/ # Game editor |
|
|
│ │ └── play/ # Game play views |
|
|
│ └── +page.svelte # Home page |
|
|
└── app.html |
|
|
``` |
|
|
|
|
|
## Documentation |
|
|
|
|
|
See [DOCUMENTATION.md](./DOCUMENTATION.md) for detailed technical documentation. |
|
|
|
|
|
## Building for Production |
|
|
|
|
|
```bash |
|
|
npm run build |
|
|
npm run preview |
|
|
``` |
|
|
|
|
|
## License |
|
|
|
|
|
MIT License - Feel free to use, modify, and distribute. |
|
|
|
|
|
*This is a fan-made project inspired by Jeopardy! and its Estonian counterpart Kuldvillak. Not affiliated with or endorsed by the original shows.*
|
|
|
|
