|
|
# Ultimate Gaming 🎮 |
|
|
|
|
|
A web-based platform for hosting trivia game shows, featuring **Kuldvillak** (Estonian Jeopardy) and **Rooside Sõda** (Estonian Family Feud, coming soon). |
|
|
|
|
|
## 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 |
|
|
``` |
|
|
|
|
|
## Usage |
|
|
This game is shared for friends to play locally and provide feedback only. |
|
|
Please respect the limitations in the LICENSE file. |
|
|
|
|
|
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 |
|
|
6. **Extend your Display**: Keep the moderator view on your screen, move the projector view on the projector and you're good to go! |
|
|
|
|
|
## 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 |
|
|
``` |
|
|
|
|
|
**DISCLAIMER**: This is an unofficial fan project for personal entertainment only. |
|
|
All Kuldvillak-related assets, sounds, and graphics are property of Kanal2 and the original Kuldvillak copyright holders. This project is not endorsed by or affiliated with the official show. |
