A modern full-stack web application for creating and playing card-based storytelling games, featuring AI-powered content generation and real-time multiplayer gameplay.

Meeplix is a digital platform inspired by storytelling games like Dixit, where players use creative prompts and images to tell stories, vote, and compete in rounds of imaginative gameplay. The platform combines modern web technologies with AI-powered content generation to create unique gaming experiences.

• 🎨 AI-Powered Content Generation: Generate creative Dixit-style prompts using Google Gemini AI
• 🎮 Real-time Multiplayer Gameplay: Play with friends in real-time game sessions
• 🃏 Custom Deck Management: Create and manage custom card decks
• 🌍 Internationalization: Multi-language support with Paraglide.js
• 🔐 Secure Authentication: User authentication and session management
• 📱 Responsive Design: Works seamlessly across desktop and mobile devices
• 🎯 Type-Safe Development: End-to-end type safety with shared types

• Svelte 5 - Modern reactive web framework with runes
• SvelteKit - Full-stack framework with SSR/SSG
• TypeScript - Type-safe development
• Tailwind CSS - Utility-first CSS framework
• Bits UI - Headless UI components
• Paraglide.js - Type-safe internationalization

• Elysia - Fast and type-safe backend framework
• Bun - JavaScript runtime and package manager
• TypeBox - JSON Schema validation
• Drizzle ORM - Type-safe database ORM
• PostgreSQL - Relational database

• Google Gemini AI - Creative prompt generation
• Runware SDK - Image generation service
• Azure Blob Storage - Cloud file storage

• Docker - Containerization for PostgreSQL
• Biome - Code formatting and linting
• Cocogitto - Conventional Commits
• Eden - End-to-end type safety

• Bun (recommended) or Node.js 18+
• Docker for database
• Google Gemini API key
• Runware API key
• Azure Storage account (optional)

1. Clone the repository

   git clone https://github.com/yourusername/meeplix.git
   cd meeplix

2. Install dependencies

   bun install

3. Start the database

   docker-compose up -d postgres

4. Set up environment variables

   # Copy example env files and configure
   cp server/.env.example server/.env
   cp client/.env.example client/.env

5. Run database migrations

   cd server
   bun run db:push

6. Start development servers

   # Terminal 1 - Backend
   cd server
   bun run dev
   
   # Terminal 2 - Frontend
   cd client
   bun run dev

DATABASE_URL="postgresql://meeplix_user:meeplix_password@localhost:5432/meeplix_db"
GEMINI_API_KEY="your-gemini-api-key"
AZURE_STORAGE_CONNECTION_STRING="your-azure-connection-string"

PUBLIC_API_URL="http://localhost:3000"

meeplix/
├── client/                 # SvelteKit frontend application
│   ├── src/
│   │   ├── lib/           # Shared components and utilities
│   │   ├── routes/        # SvelteKit file-based routing
│   │   └── app.html       # HTML template
│   ├── static/            # Static assets
│   └── package.json
├── server/                 # Elysia backend application
│   ├── src/               # Server source code
│   ├── drizzle/           # Database migrations
│   └── package.json
├── shared/                 # Shared types and utilities
│   ├── api.ts             # API type definitions
│   ├── models/            # Database models
│   └── utils.ts           # Shared utilities
├── ai/                     # AI integration modules
│   ├── gemini/            # Google Gemini integration
│   ├── runware/           # Runware image generation
│   └── azure/             # Azure storage integration
└── docker-compose.yml     # Development database setup

Generate creative storytelling prompts using Google Gemini AI:

# Interactive prompt generation
bun run dixit-prompts

# Generate prompts for specific topic
bun run dixit-prompts-simple "nature"

• Create custom card decks
• Import/export deck configurations
• AI-generated card content
• Community deck sharing

• Real-time game sessions
• Voting mechanics
• Score tracking
• Round-based gameplay

# Generate migrations
bun run db:generate

# Apply migrations
bun run db:migrate

# Push schema changes
bun run db:push

# Open Drizzle Studio
bun run db:studio

# Build frontend
cd client && bun run build

# Build backend
cd server && bun run build

The project supports multiple languages using Paraglide.js:

# Compile translations
cd client && bun run paraglide:compile

Translation files are located in client/messages/ directory.

# Build all packages
bun run build

# Start production server
bun run start

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Inspired by the creativity of Dixit and similar storytelling games
• Built with modern web technologies and AI integration
• Community feedback and contributions

Made with ❤️ for creative storytellers and game enthusiasts