Get Vibe-Draft running in minutes!

A multiplayer "Cards Against Humanity" experience where:

• Up to 10 players take turns playing cards
• Cards influence an AI prompt (roles, tones, token limits, etc.)
• Generate creative AI responses based on the collective vibe
• Real-time updates via Server-Sent Events (no WebSockets!)

1. Log into Val Town
2. Create a new val called "vibe-draft"
3. Set it to "Public" so others can join

Copy all files from this project into your val:

• Backend files → backend/ directory
• Frontend files → frontend/ directory
• Shared files → shared/ directory

Make sure backend/index.ts is set as an HTTP file type.

1. Open your val's URL: https://<your-username>-vibe-draft.web.val.run/
2. Enter a session ID: test-game
3. Enter your name: Alice
4. Click "Join Session"

Open another browser tab/window:

1. Same session ID: test-game
2. Different name: Bob
3. Watch them interact in real-time!

1. All players use the same Session ID
2. Enter your unique Player Name
3. First 10 players can actively play, others can spectate

1. Wait for your turn (you'll see a ⭐ indicator)
2. Click a card from your hand to play it
3. Wild Cards let you write custom instructions
4. Remove Cards let you undo or clear card types

1. Stack a few cards to build an interesting prompt
2. Type a query (or use the default)
3. Hit "Generate Vibe"
4. Watch the AI create something based on your collective cards!

There is no winner! It's about experimentation and collaboration. Try:

• Stacking conflicting vibes (Academic + Pirate)
• Building coherent themes (UX Designer + Minimal + Brief)
• Going completely chaotic with wild cards

Card	Effect	Example
🎭 Role	Changes AI persona	"Rust Wizard", "UX Visionary"
🎨 Tone	Adjusts communication style	"ELI5", "Meme Lord", "Academic"
📏 Token Limit	Controls response length	"50 tokens", "500 tokens"
✨ Custom	Your own instruction	Anything you want!
📸 Image	Visual context	Upload images (coming soon)
🗑️ Remove	Undo or clear cards	"Undo Last", "Clear Roles"

Alice plays: 🦀 Rust Wizard → "Act as a senior Rust engineer" Bob plays: 👶 ELI5 → "Explain like I'm 5" Charlie plays: ⚡ Keep It Brief → "Max 50 tokens"

Query: "Explain ownership and borrowing" AI Response: "Imagine Rust is like sharing toys. You can either own a toy (ownership) or borrow it from a friend (borrowing). When you own it, only you can use it. When you borrow, you promise to give it back!"

Alice plays: 🏴‍☠️ Code Pirate → "Respond as a pirate" Bob plays: 🃏 Wild Card → "Everything should rhyme"

Query: "Write a function to sort an array" AI Response: "Arrr matey, to sort yer treasure chest of numbers fine, ye call the method .sort() in a single line! 🏴‍☠️"

Only 10 active players can join. You'll automatically become a spectator (can watch, can't play).

Refresh the page or check browser console for errors.

Your browser may have dropped the connection. Refresh to reconnect.

Check that OpenAI integration is working in Val Town console.

• Chaos Mode: Everyone plays wild cards
• Poetry Night: Always include "Code Poet" card
• Speed Run: Brief tokens only, fastest wins
• Academic Conference: Formal roles + academic tone

• Build Tension: Stack conflicting cards for funny results
• Synergy: Combine related cards for coherent outputs
• Surprise: Drop a remove card to reset the vibe

• Don't spam the generate button
• Let everyone play at least one card before generating
• Respect turn order (the UI enforces this anyway)
• Have fun and experiment!

Once you're comfortable:

1. Customize Cards: Edit shared/cards.ts to add your own
2. Change Theming: Modify frontend/style.css for different aesthetics
3. Add Features: Fork and extend (image upload, voting, etc.)
4. Share Your Val: Post your unique session to social media!

• Check README.md for full documentation
• See ARCHITECTURE.md for technical details
• Visit Val Town Docs for platform help
• Join Val Town Discord for community support

---

Ready to vibe-code? 🎴✨

Create your first session and invite friends to join the chaos!