Turn awkward dates into unforgettable connections through meaningful conversations

Spark & Tell is an interactive conversation game designed for couples to deepen their connection through thoughtful questions, playful challenges, and meaningful conversations. No awkward silences, just genuine moments of connection.

1. Roll the Dice - Each number corresponds to a different category
2. Answer Questions - Share your thoughts, stories, and dreams
3. Award Sparks - Give your partner points based on their answers
4. Connect & Win - The real victory is the connection you build together

• 🎲 6 Unique Categories - From icebreakers to deep conversations
• ✨ Spark Awarding System - Reward your partner for great answers
• ⚡ Power-Ups - Skip, re-roll, or both answer for added fun
• 📊 Progress Tracking - See your connection score grow
• 📱 Mobile Responsive - Play on any device
• 🎨 Beautiful Animations - Smooth, engaging user experience
• 💾 No Sign-up Required - Jump right in and start playing

1. 🧊 Icebreakers - Light, fun questions to get started
2. ✨ Dreams & Adventures - Explore aspirations and future plans
3. 🤔 Would You Rather - Fun dilemmas and choices
4. 📖 Story Time - Share personal stories and memories
5. 🔥 Spicy - Flirty and romantic questions
6. 💭 Deep Dive - Meaningful, vulnerable conversations

• Framework: Next.js 15 with App Router
• Language: TypeScript
• Styling: Tailwind CSS v4
• Animations: Framer Motion
• State Management: Zustand
• Package Manager: Bun
• Deployment: Vercel

• Node.js 18+ or Bun (recommended)
• Git

1. Clone the repository:

git clone https://github.com/yourusername/spark-and-tell.git
cd spark-and-tell

2. Install dependencies:

bun install
# or
npm install

3. Run the development server:

bun dev
# or
npm run dev

4. Open http://localhost:3000 in your browser

bun run build
bun run start

Questions are stored in src/data/questions.json. Each question follows this structure:

{
  "id": "unique-id",
  "category": 1,
  "difficulty": 1,
  "points": 1,
  "text": "Your question here",
  "tags": ["tag1", "tag2"],
  "type": "standard"
}

Categories are defined in src/types/game.ts:

export enum Category {
  ICEBREAKER = 1,
  DREAMS = 2,
  WOULD_YOU_RATHER = 3,
  STORY_TIME = 4,
  SPICY = 5,
  DEEP_DIVE = 6,
}

spark-and-tell/
├── src/
│   ├── app/                 # Next.js app directory
│   │   ├── _components/     # React components
│   │   ├── layout.tsx       # Root layout
│   │   └── page.tsx         # Home page
│   ├── data/
│   │   └── questions.json   # Question database
│   ├── store/
│   │   └── gameStore.ts     # Zustand store
│   └── types/
│       └── game.ts          # TypeScript types
├── public/                  # Static assets
└── package.json            # Dependencies

Contributions are welcome! Feel free to:

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

• Add more questions to existing categories
• Create new question categories
• Add sound effects and music
• Implement additional power-ups
• Add multiplayer support
• Create themed question packs
• Improve accessibility features

If you enjoy Spark & Tell and it helps bring you closer to your partner, consider:

• ⭐ Starring this repository
• 🔄 Sharing it with friends
• ☕ Buying me a coffee

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

• Built with love for couples everywhere
• Inspired by the need for deeper connections in the digital age
• Special thanks to all contributors and supporters

Elliott Chong - @elliottchong

Project Link: https://github.com/yourusername/spark-and-tell

Made with ❤️ for meaningful connections