Skip to content

io-benjamin/family-prompts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1 Commit
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ’¬ Family Prompts

Bring families closer, one question at a time.

MIT License GitHub Pages

365+ conversation prompts to spark meaningful family discussions. Free, open source, and available for everyone.

🌐 Live Site: io-benjamin.github.io/family-prompts


✨ Why This Exists

Screens have made it harder for families to truly connect. A simple question at dinner can spark stories, laughter, and understanding that lasts a lifetime.

Family Prompts exists to help:

  • Parents who want deeper conversations with their kids
  • Families looking for meaningful dinner table discussions
  • Teachers who need ice-breakers for classrooms
  • Anyone who wants to connect more deeply with loved ones

Free forever. Open source. For every family.


πŸ“¦ Features

🎯 Prompts Database

  • 370+ carefully crafted prompts
  • 6 categories: Memories, Gratitude, Dreams, Funny, Deep, Traditions
  • Age-appropriate tags: Kids, Teens, Adults, All-ages

πŸ”Œ Free API

No authentication required. CORS enabled. Use it in your apps!

🧩 Embeddable Widget

Drop a single script tag on any website to show daily prompts.


πŸš€ Quick Start

Use the API

# Get all prompts
curl https://io-benjamin.github.io/family-prompts/api/prompts.json

# Get prompts by category
curl https://io-benjamin.github.io/family-prompts/api/category/memories.json
curl https://io-benjamin.github.io/family-prompts/api/category/gratitude.json
curl https://io-benjamin.github.io/family-prompts/api/category/dreams.json
curl https://io-benjamin.github.io/family-prompts/api/category/funny.json
curl https://io-benjamin.github.io/family-prompts/api/category/deep.json
curl https://io-benjamin.github.io/family-prompts/api/category/traditions.json

Response Format

{
  "id": 1,
  "text": "What's your earliest happy memory?",
  "category": "memories",
  "age": "all-ages"
}

Get Today's Prompt (JavaScript)

const response = await fetch('https://io-benjamin.github.io/family-prompts/api/prompts.json');
const data = await response.json();

// Calculate today's prompt based on day of year
const today = new Date();
const start = new Date(today.getFullYear(), 0, 0);
const dayOfYear = Math.floor((today - start) / (1000 * 60 * 60 * 24));
const todaysPrompt = data.prompts[dayOfYear % data.prompts.length];

console.log(todaysPrompt.text);

🧩 Embed the Widget

Add Family Prompts to your website with a single line:

<script src="https://io-benjamin.github.io/family-prompts/widget.js"></script>

Customize Colors

<div id="family-prompt-widget" 
  data-bg="#FFF8F0" 
  data-text="#3D405B"
  data-accent="#E07A5F">
</div>
<script src="https://io-benjamin.github.io/family-prompts/widget.js"></script>

Options:

  • data-bg - Background color
  • data-text - Text color
  • data-accent - Button/accent color

πŸ“‚ Categories

Category Emoji Description Count
Memories πŸ“Έ Cherished moments from the past 50
Gratitude πŸ™ Reflecting on the good things 50
Dreams ✨ Hopes, aspirations, imagination 50
Funny πŸ˜‚ Light-hearted laughs 50
Deep πŸ’­ Meaningful conversations 50
Traditions 🏠 Family customs and uniqueness 50

🀝 Contributing

We'd love more prompts! Here's how to contribute:

  1. Fork this repository
  2. Add your prompt to src/data/prompts.json
  3. Include: text, category, and age tag
  4. Submit a Pull Request

Prompt Format

{
  "id": 371,
  "text": "Your amazing conversation prompt here?",
  "category": "memories",
  "age": "all-ages"
}

Age Tags

  • kids - Ages 5-12
  • teens - Ages 13-17
  • adults - Ages 18+
  • all-ages - Everyone

Guidelines

  • Keep prompts open-ended (not yes/no)
  • Family-friendly content only
  • Avoid anything too personal or uncomfortable
  • Aim for prompts that spark stories, not just answers

πŸ› οΈ Development

# Clone the repo
git clone https://github.com/io-benjamin/family-prompts.git
cd family-prompts

# Install dependencies
npm install

# Run development server
npm run dev

# Build for production
npm run build

πŸ“ License

MIT License - see LICENSE for details.

Free to use, modify, and distribute. Attribution appreciated but not required.


πŸ’– Made With Love

Created by Io Benjamin to help families connect.

If this helps your family, consider:

  • ⭐ Starring this repo
  • πŸ› Reporting issues
  • πŸ’‘ Contributing prompts
  • πŸ“’ Sharing with other families

"The best conversations start with a good question." πŸ’¬

About

Bring families closer, one question at a time. 365+ daily conversation prompts for families. Free, open source, and available for everyone.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors