https://github.com/paladini/aa-daily-reflections-database
Alcoholics Anonymous (AA) Daily Reflections in English, Spanish, French and Brazilian Portuguese
https://github.com/paladini/aa-daily-reflections-database
aa alcoholics-anonymous daily-reflections data database reflections
Last synced: about 2 months ago
JSON representation
Alcoholics Anonymous (AA) Daily Reflections in English, Spanish, French and Brazilian Portuguese
- Host: GitHub
- URL: https://github.com/paladini/aa-daily-reflections-database
- Owner: paladini
- License: other
- Created: 2025-06-28T22:53:26.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-07-03T02:13:51.000Z (3 months ago)
- Last Synced: 2025-07-03T03:24:38.007Z (3 months ago)
- Topics: aa, alcoholics-anonymous, daily-reflections, data, database, reflections
- Language: Python
- Homepage:
- Size: 1.32 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📖 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.*
[](https://opensource.org/licenses/MIT)
[]()
**📖 Read this in other languages:** [🇪🇸 Español](README_ES.md) | [🇫🇷 Français](README_FR.md) | [🇧🇷 Português](README_PT.md)
## 🌐 Live Portal
**[📖 Access the Live Portal](https://paladini.github.io/aa-daily-reflections-database)**
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](https://github.com/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](https://github.com/paladini/aa-daily-reflections-database) or [☕ supporting the project](https://github.com/sponsors/paladini).*
## 🚀 Quick Download
Choose your preferred format and language:
### 📊 All Languages Combined
- **CSV**: [daily_reflections_all_languages.csv](data/daily_reflections_2025_all_languages.csv)
- **SQLite**: [reflections.db](data/reflections.db)
### 📄 Individual Languages
| Language | JSON | CSV |
|----------|------|-----|
| 🇺🇸 **English** | [JSON](data/daily_reflections_english.json) | [CSV](data/daily_reflections_english.csv) |
| 🇪🇸 **Español** | [JSON](data/daily_reflections_spanish.json) | [CSV](data/daily_reflections_spanish.csv) |
| 🇫🇷 **Français** | [JSON](data/daily_reflections_french.json) | [CSV](data/daily_reflections_french.csv) |
| 🇧🇷 **Português** | [JSON](data/daily_reflections_brazilian-portuguese.json) | [CSV](data/daily_reflections_brazilian-portuguese.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:
```json
{
"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](data/README.md)**
## 💻 Code Examples
**📝 Ready-to-run examples in multiple languages: [examples/README.md](examples/README.md)**
### Quick Start
#### Python
```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
```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
```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]}")
```
### Option 2: JSON Files
```javascript
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
```python
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](CONTRIBUTING.md)
## 📜 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](https://paladini.dev)
- 📧 Email: fnpaladini+aa+database@gmail.com
- 🐙 GitHub: [@paladini](https://github.com/paladini)
### Support This Project
If this database helps your recovery journey or development work:
- ⭐ [Star this repository](https://github.com/paladini/aa-daily-reflections-database)
- 🐛 [Report issues](https://github.com/paladini/aa-daily-reflections-database/issues)
- 💡 [Suggest improvements](https://github.com/paladini/aa-daily-reflections-database/discussions)
- ☕ [Buy me a coffee](https://github.com/sponsors/paladini)
---
**"One day at a time"** 🌟
*Dedicated to the recovery community worldwide*
**Created with ❤️ by [Fernando Paladini](https://github.com/paladini)**