{"id":31608874,"url":"https://github.com/luminous-dynamics/terra-atlas","last_synced_at":"2026-05-06T10:40:29.581Z","repository":{"id":315199663,"uuid":"1058509545","full_name":"Luminous-Dynamics/terra-atlas","owner":"Luminous-Dynamics","description":"🌍 Global energy investment platform - Democratizing access to 4M+ renewable energy opportunities worldwide. Live at atlas.luminousdynamics.io","archived":false,"fork":false,"pushed_at":"2025-11-14T22:23:04.000Z","size":45146,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-15T00:22:09.375Z","etag":null,"topics":["clean-energy","climate-tech","community-ownership","consciousness-first","dual-license","energy","fintech","gift-economy","hydroelectric","investment","investment-platform","nextjs","renewable-energy","sacred-reciprocity","solar-energy","supabase","sustainability","wind-energy"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Luminous-Dynamics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-17T07:26:04.000Z","updated_at":"2025-10-03T16:20:00.000Z","dependencies_parsed_at":"2025-09-17T09:39:55.975Z","dependency_job_id":null,"html_url":"https://github.com/Luminous-Dynamics/terra-atlas","commit_stats":null,"previous_names":["luminous-dynamics/terra-atlas"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Luminous-Dynamics/terra-atlas","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luminous-Dynamics%2Fterra-atlas","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luminous-Dynamics%2Fterra-atlas/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luminous-Dynamics%2Fterra-atlas/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luminous-Dynamics%2Fterra-atlas/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Luminous-Dynamics","download_url":"https://codeload.github.com/Luminous-Dynamics/terra-atlas/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luminous-Dynamics%2Fterra-atlas/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32689724,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["clean-energy","climate-tech","community-ownership","consciousness-first","dual-license","energy","fintech","gift-economy","hydroelectric","investment","investment-platform","nextjs","renewable-energy","sacred-reciprocity","solar-energy","supabase","sustainability","wind-energy"],"created_at":"2025-10-06T08:25:52.676Z","updated_at":"2026-05-06T10:40:29.576Z","avatar_url":"https://github.com/Luminous-Dynamics.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌍 Terra Atlas MVP - The ONE Unified Version\n\n## ⚠️ IMPORTANT: This is THE version we work on!\n\n**Stop creating new demos!** This is the main Terra Atlas with the 3D globe that you liked. All improvements should be made HERE, not in new files.\n\n\u003e Democratizing Global Energy Investment - 4M+ Renewable Opportunities Worldwide\n\n[![Live Platform](https://img.shields.io/badge/Live-atlas.luminousdynamics.io-green)](https://atlas.luminousdynamics.io)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Next.js](https://img.shields.io/badge/Next.js-15.5-black)](https://nextjs.org/)\n[![Supabase](https://img.shields.io/badge/Supabase-Database-green)](https://supabase.com/)\n\n## 🚀 The Platform\n\nTerra Atlas is revolutionizing energy investment by connecting everyday investors with renewable energy opportunities globally. Starting with 87,000 untapped dams in the US ready for hydroelectric retrofitting, we're building the infrastructure for community-owned energy.\n\n### Live at [atlas.luminousdynamics.io](https://atlas.luminousdynamics.io)\n\n## 💡 Key Features\n\n- **🌐 Interactive 3D Globe** - Visualize energy projects worldwide\n- **📊 Real-Time Data** - FERC queue tracking (11,547 active projects)\n- **💰 Investment Calculator** - Project ROI with transparency\n- **🏛️ Regenerative Exit Model** - 7-year path to community ownership\n- **🇨🇭 Swiss Foundation** - Immutable mission via Luminous Chimera structure\n- **📈 Portfolio Management** - Track and manage your energy investments\n\n## 🎯 The Opportunity\n\n### Immediate Impact\n- **$60B** opportunity in US dam retrofitting alone\n- **87,000** existing dams ready for hydroelectric conversion\n- **4M+** global renewable energy sites identified\n- **11-14%** IRR for investors with tax optimization\n\n### Revolutionary Model\n- **Luminous Chimera**: Swiss foundation ensures mission permanence\n- **Community Ownership**: Platform transitions to users over 7 years\n- **Tax Efficiency**: 30-40% more capital to communities\n- **Democratic Access**: Invest from $10 to $10M\n\n## 🛠️ Tech Stack\n\n- **Frontend**: Next.js 15.5, React 19, TypeScript, Tailwind CSS\n- **Backend**: Supabase (PostgreSQL), Prisma ORM, Drizzle\n- **Maps**: Mapbox GL for interactive visualizations\n- **Deployment**: Vercel with edge functions\n- **Data Sources**: FERC, USACE, SMR pipelines, GIS databases\n\n## 🏗️ Development Setup\n\n### Prerequisites\n- Node.js 20+\n- npm or yarn\n- Supabase account (for database)\n\n### Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/Luminous-Dynamics/terra-atlas.git\ncd terra-atlas\n\n# Install dependencies\nnpm install\n\n# Set up environment variables\ncp .env.example .env.local\n# Edit .env.local with your Supabase credentials\n\n# Run development server\nnpm run dev\n\n# Open http://localhost:3000\n```\n\n### Environment Variables\n\n```env\nNEXT_PUBLIC_SUPABASE_URL=your_supabase_url\nNEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key\nSUPABASE_SERVICE_ROLE_KEY=your_service_key\nDATABASE_URL=your_postgres_connection_string\n```\n\n## 📁 Project Structure\n\n```\nterra-atlas/\n├── app/                    # Next.js app directory\n│   ├── api/               # API routes\n│   ├── dashboard/         # User dashboard\n│   └── projects/          # Project pages\n├── components/            # React components\n│   ├── Globe3D.tsx       # Interactive 3D visualization\n│   ├── ProjectCard.tsx   # Project display cards\n│   └── ROICalculator.tsx # Investment calculator\n├── lib/                   # Utilities and helpers\n│   ├── supabase/         # Database client\n│   └── utils/            # Helper functions\n├── data/                  # Static data files\n│   ├── ferc-queue.json  # FERC project data\n│   └── dam-sites.json   # USACE dam database\n└── public/               # Static assets\n```\n\n## 🗺️ Roadmap\n\n### Phase 1: MVP (Complete ✅)\n- Interactive globe with 250+ demo projects\n- Basic investment calculator\n- User authentication\n- Project search and filtering\n\n### Phase 2: Data Integration (In Progress 🚧)\n- FERC queue real-time updates\n- USACE dam database integration\n- SMR project pipeline tracking\n- Weather and grid data layers\n\n### Phase 3: Investment Features (Q1 2025)\n- Pledge system for projects\n- Portfolio management\n- Community forums\n- Smart contract integration\n\n### Phase 4: Community Ownership (Q2 2025)\n- DAO governance structure\n- Token economics design\n- Voting mechanisms\n- Revenue sharing system\n\n## 🤝 Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n### Areas We Need Help\n- Data integration from energy databases\n- UI/UX improvements\n- Smart contract development\n- Community features\n- Documentation\n- Testing\n\n## 📊 Current Stats\n\n- **250+** demonstration projects live\n- **11,547** FERC queue projects tracked\n- **87,000** potential dam sites mapped\n- **$60B** investment opportunity identified\n\n## 🏛️ Governance\n\nTerra Atlas operates under the Luminous Chimera model:\n- Swiss Foundation holds golden share\n- Mission legally immutable\n- 7-year transition to community ownership\n- Transparent governance via DAO\n\n## 📄 License\n\nMIT License - We're building public good infrastructure for energy democracy.\n\n## 🔗 Links\n\n- **Live Platform**: [atlas.luminousdynamics.io](https://atlas.luminousdynamics.io)\n- **Investment Deck**: [terra.luminousdynamics.org](https://terra.luminousdynamics.org)\n- **Documentation**: [docs.luminousdynamics.org](https://docs.luminousdynamics.org)\n- **Organization**: [github.com/Luminous-Dynamics](https://github.com/Luminous-Dynamics)\n\n## 💬 Contact\n\n- **Email**: invest@luminousdynamics.org\n- **Discord**: [Join our community](https://discord.gg/luminous)\n- **Twitter**: [@LuminousDynamics](https://twitter.com/LuminousDynamics)\n\n---\n\n*Built with consciousness-first principles and love for our planet 🌍💚*\n\n**Terra Atlas** - Where energy meets democracy, and investment serves community.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluminous-dynamics%2Fterra-atlas","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluminous-dynamics%2Fterra-atlas","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluminous-dynamics%2Fterra-atlas/lists"}