{"id":30354537,"url":"https://github.com/paladini/aa-daily-reflections-database","last_synced_at":"2026-04-16T01:33:04.370Z","repository":{"id":302557194,"uuid":"1010361989","full_name":"paladini/aa-daily-reflections-database","owner":"paladini","description":"Alcoholics Anonymous (AA) Daily Reflections in English, Spanish, French and Brazilian Portuguese","archived":false,"fork":false,"pushed_at":"2025-07-04T02:23:56.000Z","size":2061,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-19T03:49:50.704Z","etag":null,"topics":["aa","alcoholics-anonymous","daily-reflections","data","database","reflections"],"latest_commit_sha":null,"homepage":"https://paladini.github.io/aa-daily-reflections-database/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paladini.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-28T22:53:26.000Z","updated_at":"2025-07-04T02:23:21.000Z","dependencies_parsed_at":"2025-07-03T03:24:43.312Z","dependency_job_id":"b89280be-bce6-4585-bbfb-2150e450989b","html_url":"https://github.com/paladini/aa-daily-reflections-database","commit_stats":null,"previous_names":["paladini/aa-daily-reflections-database"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/paladini/aa-daily-reflections-database","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paladini%2Faa-daily-reflections-database","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paladini%2Faa-daily-reflections-database/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paladini%2Faa-daily-reflections-database/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paladini%2Faa-daily-reflections-database/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paladini","download_url":"https://codeload.github.com/paladini/aa-daily-reflections-database/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paladini%2Faa-daily-reflections-database/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31867710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aa","alcoholics-anonymous","daily-reflections","data","database","reflections"],"created_at":"2025-08-19T03:36:43.144Z","updated_at":"2026-04-16T01:33:04.341Z","avatar_url":"https://github.com/paladini.png","language":"JavaScript","funding_links":["https://github.com/sponsors/paladini"],"categories":[],"sub_categories":[],"readme":"# 📖 AA Daily Reflections Database\n\n**Complete year of Alcoholics Anonymous Daily Reflections in English, Spanish, French, and Brazilian Portuguese**\n\n*365 daily meditations and spiritual reflections from AA available in multiple formats (SQLite, JSON, CSV) for recovery apps, multilingual communities, and personal spiritual practice.*\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Languages](https://img.shields.io/badge/Languages-4-blue.svg)]()\n\n**📖 Read this in other languages:** [🇪🇸 Español](README_ES.md) | [🇫🇷 Français](README_FR.md) | [🇧🇷 Português](README_PT.md)\n\n## 🌐 Live Portal\n\n**[📖 Access the Live Portal](https://paladini.github.io/aa-daily-reflections-database)**\n\nBrowse and read daily reflections in a beautiful, multilingual web interface with:\n- 🌍 **4 languages**: English, Spanish, French, Brazilian Portuguese\n- 📅 **Easy navigation**: Previous/Next day, date picker, \"Today\" button\n- 📱 **Responsive design**: Works perfectly on mobile and desktop\n- 🔗 **Shareable URLs**: Every reflection has a unique, shareable link\n- 🔍 **SEO optimized**: Each reflection is searchable and indexable\n\n---\n\n## 👨‍💻 Created by Fernando Paladini\n\nThis database and portal were **compiled, developed, and maintained** by [Fernando Paladini](https://github.com/paladini).\n\n- **📊 Data Compilation**: Carefully collected and structured from official AA sources\n- **🌐 Multilingual Translation**: Sourced authentic translations in 4 languages  \n- **💻 Portal Development**: Built a modern React-based web portal\n- **🔧 Technical Implementation**: Database design, API structure, and deployment\n- **📈 SEO Optimization**: Multilingual SEO with hreflang, structured data, and sitemaps\n\n*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).*\n\n## 🚀 Quick Download\n\nChoose your preferred format and language:\n\n### 📊 All Languages Combined\n- **CSV**: [daily_reflections_all_languages.csv](data/daily_reflections_2025_all_languages.csv)\n- **SQLite**: [reflections.db](data/reflections.db)\n\n### 📄 Individual Languages\n| Language | JSON | CSV |\n|----------|------|-----|\n| 🇺🇸 **English** | [JSON](data/daily_reflections_english.json) | [CSV](data/daily_reflections_english.csv) |\n| 🇪🇸 **Español** | [JSON](data/daily_reflections_spanish.json) | [CSV](data/daily_reflections_spanish.csv) |\n| 🇫🇷 **Français** | [JSON](data/daily_reflections_french.json) | [CSV](data/daily_reflections_french.csv) |\n| 🇧🇷 **Português** | [JSON](data/daily_reflections_brazilian-portuguese.json) | [CSV](data/daily_reflections_brazilian-portuguese.csv) |\n\n## 📋 What's Included\n\n- **Complete year coverage**: All 365 days of AA daily reflections\n- **Multilingual**: Available in English, Spanish, French, and Brazilian Portuguese\n- **Complete data**: Title, quote, reflection text, and source reference\n- **Multiple formats**: SQLite database, JSON files, and CSV spreadsheets\n- **Ready to use**: Perfect for apps, websites, or personal projects\n\n## 📊 Data Structure\n\nEach reflection contains:\n\n```json\n{\n  \"date\": \"2025-01-01\",\n  \"language\": \"english\",\n  \"title\": \"I AM A MIRACLE\",\n  \"quote\": \"The central fact of our lives today...\",\n  \"text\": \"This truly is a fact in my life today...\",\n  \"content\": \"ALCOHOLICS ANONYMOUS, p. 25\"\n}\n```\n\n**📁 For more details about data formats, see [data/README.md](data/README.md)**\n\n## 💻 Code Examples\n\n**📝 Ready-to-run examples in multiple languages: [examples/README.md](examples/README.md)**\n\n### Quick Start\n\n#### Python\n```python\nimport sqlite3\n\nconn = sqlite3.connect('data/reflections.db')\ncursor = conn.cursor()\n\n# Get today's reflection\ncursor.execute(\"\"\"\n    SELECT title, quote, text FROM reflections \n    WHERE date = date('now') AND language = 'english'\n\"\"\")\nreflection = cursor.fetchone()\nprint(f\"Today: {reflection[0]}\")\n```\n\n#### JavaScript\n```javascript\nconst fs = require('fs');\n\n// Load English reflections\nconst reflections = JSON.parse(\n    fs.readFileSync('data/english/daily_reflections_english.json', 'utf8')\n);\n\n// Get today's date\nconst today = new Date().toISOString().split('T')[0];\nconst todayReflection = reflections.find(r =\u003e r.date === today);\n\nconsole.log(`Today: ${todayReflection.title}`);\n```\n\n## 🚀 Getting Started\n\n### Option 1: SQLite Database\n```python\nimport sqlite3\n\nconn = sqlite3.connect('data/reflections.db')\ncursor = conn.cursor()\n\n# Get today's reflection\ncursor.execute(\"\"\"\n    SELECT title, quote, text FROM reflections \n    WHERE date = date('now') AND language = 'english'\n\"\"\")\nreflection = cursor.fetchone()\nprint(f\"Today: {reflection[0]}\")\n```\n\n### Option 2: JSON Files\n```javascript\nconst fs = require('fs');\nconst reflections = JSON.parse(\n    fs.readFileSync('data/english/daily_reflections_english.json', 'utf8')\n);\n\nconst today = new Date().toISOString().split('T')[0];\nconst todayReflection = reflections.find(r =\u003e r.date === today);\nconsole.log(`Today: ${todayReflection.title}`);\n```\n\n### Option 3: CSV Files  \n```python\nimport pandas as pd\n\n# Load all languages\ndf = pd.read_csv('data/daily_reflections_2025_all_languages.csv')\n\n# Filter by language and date\nenglish_reflections = df[df['language'] == 'english']\n```\n\n## 🌍 Available Languages\n\n| Language | Code | Native Name | Coverage |\n|----------|------|-------------|----------|\n| English  | `en` | English     | Complete year (365 days) |\n| French   | `fr` | Français    | Complete year (365 days) |\n| Spanish  | `es` | Español     | Complete year (365 days) |\n| Brazilian Portuguese  | `pt-BR` | Português do Brasil     | Complete year (365 days) |\n\n## 🤝 Contributing\n\nFound an error or want to help? See our [contributing guidelines](CONTRIBUTING.md)\n\n## 📜 License\n\nMIT License - Free to use for educational and recovery purposes.\n\n**Important**: This is an unofficial compilation. Original content belongs to Alcoholics Anonymous World Services, Inc.\n\n## 🙏 Acknowledgments\n\n- **Alcoholics Anonymous World Services, Inc.** for the original daily reflections content\n- **AA communities worldwide** who provided translations and cultural adaptations\n- **Recovery community** for inspiration and feedback\n\n## 📬 Contact \u0026 Support\n\n**Fernando Paladini** - Project Creator \u0026 Maintainer\n- 🌐 Website: [paladini.dev](https://paladini.dev)\n- 📧 Email: fnpaladini+aa+database@gmail.com\n- 🐙 GitHub: [@paladini](https://github.com/paladini)\n\n### Support This Project\nIf this database helps your recovery journey or development work:\n- ⭐ [Star this repository](https://github.com/paladini/aa-daily-reflections-database)\n- 🐛 [Report issues](https://github.com/paladini/aa-daily-reflections-database/issues)\n- 💡 [Suggest improvements](https://github.com/paladini/aa-daily-reflections-database/discussions)\n- ☕ [Buy me a coffee](https://github.com/sponsors/paladini)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**\"One day at a time\"** 🌟  \n*Dedicated to the recovery community worldwide*\n\n**Created with ❤️ by [Fernando Paladini](https://github.com/paladini)**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaladini%2Faa-daily-reflections-database","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpaladini%2Faa-daily-reflections-database","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpaladini%2Faa-daily-reflections-database/lists"}