Ecosystem setup for the TopLocs decentralized P2P community platform
This repository orchestrates the entire TopLocs development environment through AI automation.
git clone git@github.com:toplocs/toplocs-workspace.git toplocs
cd toplocs && claudeThen use this prompt:
I just cloned the toplocs-workspace repository. Please help me set up the complete TopLocs ecosystem by reading the documentation, cloning all repositories, and setting up the development environment. I want to work on: [your goals]
👉 Complete Getting Started Guide
toplocs-workspace/ (this repository)
├── README.md # Quick start guide
├── CLAUDE.md # Comprehensive AI context
├── docs/ # Setup guides & documentation
├── docusaurus/ # 📚 Documentation site (Docusaurus)
└── .gitignore # Excludes auto-cloned repos
Auto-cloned repositories (after AI setup):
├── tribelike/ # ⭐ Core P2P platform
├── locations/ # Mobile app (Ionic)
├── *-plugin/ # Plugin repositories
└── [others] # Development tools & docs
Live Documentation: https://toplocs.github.io/toplocs-workspace/
The docusaurus/ folder contains our centralized documentation site that aggregates docs from all TopLocs repositories.
- Local Development:
cd docusaurus && pnpm start - Auto-deploys: Via GitHub Actions on push to main
- Multi-source: Pulls docs from workspace, tribelike, and plugins
Learn more about the documentation system →
- ❌ Complex multi-repo setup
- ❌ Outdated documentation
- ❌ Inconsistent environments
- ❌ Hours of configuration
- ✅ 30-second setup: AI handles everything
- ✅ Always current: AI reads latest documentation
- ✅ Consistent environments: Same setup for everyone
- ✅ Intelligent guidance: AI understands your goals
TopLocs is a decentralized P2P community platform built on Gun.js:
- No Central Server: Data distributed across peers
- User-Owned Data: Cryptographic keys ensure control
- Offline-First: Works without internet
- Plugin-Based: Extensible through Module Federation
- Real-Time Sync: Instant updates between peers
- Clone all repositories from GitHub
- Install dependencies and configure environments
- Provide ecosystem context and guidance
- Cross-repository coordination
- Architecture guidance for P2P patterns
- Plugin development with Module Federation
- P2P migration assistance for legacy code
- Keep docs synchronized across repos
- Update AI context as ecosystem evolves
- Maintain getting-started guides
- Simplified GitHub Actions (deploy docs only)
- Manual sync workflow for repository analysis and documentation updates
- 📋 Documentation Hub - Complete navigation and overview
- 🚀 Getting Started - AI-driven setup guide
- 🤖 AI Context - Comprehensive development context
- 🔧 Workspace Overview - System documentation
- 🏗️ Architecture - P2P platform technical details
- 🌐 Ecosystem - Repository relationships
- 🔌 Plugin Development - Create and maintain plugins
- 🐛 Debug Guide - Troubleshooting and tools
- 🤖 Automation - AI-powered maintenance system
- Use the AI setup prompt above
- Follow AI guidance for your specific goals
- Start building amazing P2P features!
- Clone this workspace
- Let AI coordinate your development environment
- Focus on innovation, not configuration
This workspace approach enables:
- Consistent onboarding for all contributors
- AI-guided development with full ecosystem context
- Simplified coordination across multiple repositories
- Focus on building rather than setup complexity
Open Source: MIT License
Community: Building the future of decentralized social platforms
Contributions: Always welcome - AI will help you get started!
Ready to build the future? Use the AI setup prompt and start contributing to decentralized communities! 🚀