📖 AA Daily Reflections Database

Complete year of Alcoholics Anonymous Daily Reflections in English, Spanish, French, and Brazilian Portuguese

365 daily meditations and spiritual reflections from AA available in multiple formats (SQLite, JSON, CSV) for recovery apps, multilingual communities, and personal spiritual practice.

📖 Read this in other languages: 🇪🇸 Español | 🇫🇷 Français | 🇧🇷 Português

🌐 Live Portal

📖 Access the Live Portal

Browse and read daily reflections in a beautiful, multilingual web interface with:

• 🌍 4 languages: English, Spanish, French, Brazilian Portuguese
• 📅 Easy navigation: Previous/Next day, date picker, "Today" button
• 📱 Responsive design: Works perfectly on mobile and desktop
• 🔗 Shareable URLs: Every reflection has a unique, shareable link
• 🔍 SEO optimized: Each reflection is searchable and indexable

---

👨‍💻 Created by Fernando Paladini

This database and portal were compiled, developed, and maintained by Fernando Paladini.

• 📊 Data Compilation: Carefully collected and structured from official AA sources
• 🌐 Multilingual Translation: Sourced authentic translations in 4 languages
• 💻 Portal Development: Built a modern React-based web portal
• 🔧 Technical Implementation: Database design, API structure, and deployment
• 📈 SEO Optimization: Multilingual SEO with hreflang, structured data, and sitemaps

If this project helps your recovery journey or development work, consider ⭐ starring the repository or ☕ supporting the project.

🚀 Quick Download

Choose your preferred format and language:

📊 All Languages Combined

• CSV: daily_reflections_all_languages.csv
• SQLite: reflections.db

📄 Individual Languages

Language	JSON	CSV
🇺🇸 English	JSON	CSV
🇪🇸 Español	JSON	CSV
🇫🇷 Français	JSON	CSV
🇧🇷 Português	JSON	CSV

📋 What's Included

• Complete year coverage: All 365 days of AA daily reflections
• Multilingual: Available in English, Spanish, French, and Brazilian Portuguese
• Complete data: Title, quote, reflection text, and source reference
• Multiple formats: SQLite database, JSON files, and CSV spreadsheets
• Ready to use: Perfect for apps, websites, or personal projects

📊 Data Structure

Each reflection contains:

{
  "date": "2025-01-01",
  "language": "english",
  "title": "I AM A MIRACLE",
  "quote": "The central fact of our lives today...",
  "text": "This truly is a fact in my life today...",
  "content": "ALCOHOLICS ANONYMOUS, p. 25"
}

📁 For more details about data formats, see data/README.md

💻 Code Examples

📝 Ready-to-run examples in multiple languages: examples/README.md

Quick Start

Python

import sqlite3

conn = sqlite3.connect('data/reflections.db')
cursor = conn.cursor()

# Get today's reflection
cursor.execute("""
    SELECT title, quote, text FROM reflections 
    WHERE date = date('now') AND language = 'english'
""")
reflection = cursor.fetchone()
print(f"Today: {reflection[0]}")

JavaScript

const fs = require('fs');

// Load English reflections
const reflections = JSON.parse(
    fs.readFileSync('data/english/daily_reflections_english.json', 'utf8')
);

// Get today's date
const today = new Date().toISOString().split('T')[0];
const todayReflection = reflections.find(r => r.date === today);

console.log(`Today: ${todayReflection.title}`);

🚀 Getting Started

Option 1: SQLite Database

import sqlite3

conn = sqlite3.connect('data/reflections.db')
cursor = conn.cursor()

# Get today's reflection
cursor.execute("""
    SELECT title, quote, text FROM reflections 
    WHERE date = date('now') AND language = 'english'
""")
reflection = cursor.fetchone()
print(f"Today: {reflection[0]}")

Option 2: JSON Files

const fs = require('fs');
const reflections = JSON.parse(
    fs.readFileSync('data/english/daily_reflections_english.json', 'utf8')
);

const today = new Date().toISOString().split('T')[0];
const todayReflection = reflections.find(r => r.date === today);
console.log(`Today: ${todayReflection.title}`);

Option 3: CSV Files

import pandas as pd

# Load all languages
df = pd.read_csv('data/daily_reflections_2025_all_languages.csv')

# Filter by language and date
english_reflections = df[df['language'] == 'english']

🌍 Available Languages

Language	Code	Native Name	Coverage
English	en	English	Complete year (365 days)
French	fr	Français	Complete year (365 days)
Spanish	es	Español	Complete year (365 days)
Brazilian Portuguese	pt-BR	Português do Brasil	Complete year (365 days)

🤝 Contributing

Found an error or want to help? See our contributing guidelines

📜 License

MIT License - Free to use for educational and recovery purposes.

Important: This is an unofficial compilation. Original content belongs to Alcoholics Anonymous World Services, Inc.

🙏 Acknowledgments

• Alcoholics Anonymous World Services, Inc. for the original daily reflections content
• AA communities worldwide who provided translations and cultural adaptations
• Recovery community for inspiration and feedback

📬 Contact & Support

Fernando Paladini - Project Creator & Maintainer

• 🌐 Website: paladini.dev
• 📧 Email: fnpaladini+aa+database@gmail.com
• 🐙 GitHub: @paladini

Support This Project

If this database helps your recovery journey or development work:

• ⭐ Star this repository
• 🐛 Report issues
• 💡 Suggest improvements
• ☕ Buy me a coffee

---

"One day at a time" 🌟
Dedicated to the recovery community worldwide

Created with ❤️ by Fernando Paladini