🏙️
FIWARE / NGSI-LD Integration
Standards-based context and entity management for smart city applications
LegoCitySmart City Builder
A reusable platform for modern, map-based urban dashboards
Skip to content
LegoCity Documentation
Welcome to LegoCity — a Smart City Builder platform for modern, map-based urban dashboards.
Quick navigation
🚀 New to LegoCity?
Start here if you are seeing LegoCity for the first time.
| Section | Description |
|---|---|
| 🚀 Getting started | Understand the core concepts and run LegoCity for the first time |
| ⬇️ Installation | Choose an installation method: local, Docker, or development environment |
| 🎓 User guide | Learn how to use maps, layers, dashboards, and entities |
| ⚙️ Configuration | Configure data sources, Mapbox, brokers, APIs, and AI integration |
🛠️ For developers
Use these sections if you want to extend or contribute to LegoCity.
| Section | Description |
|---|---|
| 💻 Development guide | Set up a dev environment, create blocks, and extend the platform |
| 🤖 AI integration | Configure the Payload AI plugin and OpenRouter-based models |
| ☁️ Deployment | Deploy LegoCity using Docker, AWS, VMs, Cloudflare, or Coolify |
| 📚 Reference | Troubleshooting, API details, and technical reference material |
Quick start
bash
# Clone repository
git clone https://github.com/CTU-SematX/LegoCity.git
cd LegoCity/dashboard
# Install dependencies
pnpm install
# Configure environment
cp .env.example .env
# Edit .env with your settings
# Start development server
pnpm devAccess at: http://localhost:3000
👉 See the Quick Start Guide for detailed instructions.
Architecture Overview
LegoCity uses a three-layer architecture:
- Context & Data Layer - FIWARE/NGSI-LD brokers with standardized city data
- Content & UI Layer - PayloadCMS + Next.js for configurable dashboards
- Integration Layer - API proxies, AI helpers, external services
👉 See the Architecture Guide for detailed diagrams and explanations.
Community & Support
Getting Help
- 📖 Documentation: You're reading it!
- 💬 Discussions: GitHub Discussions
- 🐛 Issues: GitHub Issues
- 📧 Contact: CTU-SematX Team
Contributing
We welcome contributions! See:
- Development Guide - How to contribute
- CONTRIBUTING.md - Guidelines
- CODE_OF_CONDUCT.md - Community standards
Resources
- Repository: github.com/CTU-SematX/LegoCity
- Demo: [Coming soon]
- License: Check repository for license details
What's Next?
Ready to begin? Head to the Getting Started Guide →