Meeplix

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

🎯 About

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.

✨ Features

• 🎨 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

🛠️ Tech Stack

Frontend

• 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

Backend

• 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

AI & Services

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

Development & Deployment

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

🚀 Getting Started

Prerequisites

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

Installation

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
   

Environment Variables

Server (server/.env)

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"

Client (client/.env)

PUBLIC_API_URL="http://localhost:3000"

📁 Project Structure

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

🎮 Game Features

AI Prompt Generation

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"

Deck Management

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

Multiplayer Gameplay

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

🛠️ Development

Database Operations

# 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

Building

# Build frontend
cd client && bun run build

# Build backend
cd server && bun run build

🌍 Internationalization

The project supports multiple languages using Paraglide.js:

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

Translation files are located in client/messages/ directory.

🐳 Deployment

Production Build

# Build all packages
bun run build

# Start production server
bun run start

🤝 Contributing

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

📄 License

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

🙏 Acknowledgments

• 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