Skip to content

Releases: minhe51805/UrbanReflex

v0.2.0

07 Dec 15:50
@ttadev24 ttadev24
v0.2.0
3e28417

Choose a tag to compare

View all tags
v0.2.0 Latest
Latest

UrbanReflex v0.2.0 - Production Ready with Enhanced Developer Experience

Release Date: December 7, 2025 | Status: Stable Release

What's New in v0.2.0

UI/UX Improvements

  • Enhanced citizen reporting interface with improved form validation
  • Multi-language support with language switcher (12 languages: EN, VI, ES, FR, DE, ZH, JA, KO, AR, RU, PT, HI)
  • Improved responsive design and mobile experience
  • Updated component styling and animations

Developer Experience

  • Just task runner for automated workflows (16+ commands)
  • One-command setup with automatic UV package manager installation
  • Husky pre-commit hooks for code quality enforcement
  • Prettier integration for consistent code formatting
  • Pre-commit framework with Black, Flake8, isort, ESLint

Bug Fixes

  • Fixed ModuleNotFoundError for backend models package
  • Resolved PowerShell syntax errors in Just commands
  • Corrected frontend environment file configuration
  • Fixed citizen report status tracking issues
  • Improved error handling and validation

Updated Dependencies

  • Next.js 16.0.3 → 16.0.7
  • Added Prettier 3.2.5
  • Added Husky for Git hooks
  • UV package manager for faster Python dependency resolution

Core Features

Air quality monitoring (10,000+ stations), NGSI-LD smart city infrastructure, citizen reporting with photo uploads, Gemini AI chatbot, JWT authentication, role-based access control, interactive maps with MapLibre GL.

Tech Stack

Backend: FastAPI, MongoDB, Orion-LD, Gemini AI, Pinecone
Frontend: Next.js 16.0.7, React 19, TypeScript, Tailwind CSS
Code Quality: Husky, pre-commit, Black, Flake8, isort, ESLint, Prettier
DevOps: Docker Compose, UV, Just

Documentation

README | CHANGELOG | Docs

Assets 2
Loading

v0.1.0 - Beta Release

04 Dec 16:24
@ttadev24 ttadev24
v0.1.0
5198244

Choose a tag to compare

View all tags
v0.1.0 - Beta Release

UrbanReflex v0.1.0 - Initial Beta Release

Release Date: December 4, 2025 | Status: Beta Testing

🎯 Overview

First public beta of UrbanReflex - a smart city platform for air quality monitoring and urban infrastructure management. Ready for testing and demonstration at Vietnam Open Source Software Competition.

✨ Key Features

  • Air Quality Monitoring: Real-time AQI data, interactive map with 10,000+ stations, historical trends, health recommendations
  • Smart City Infrastructure: NGSI-LD compliance, Orion Context Broker, road/streetlight monitoring, POI management
  • Citizen Reporting: Submit issues with photos, status tracking, priority assignment, admin dashboard
  • AI Services: Gemini chatbot, NLP queries, vector search (Pinecone), intelligent classification
  • User Management: JWT auth, role-based access (Citizen/Admin/Official), API key support
  • Modern UI: Responsive design, MapLibre GL, Chart.js visualization, dark mode, Tailwind CSS

🚀 Quick Start

# Clone and start
git clone -b v0.1.0 https://github.com/minhe51805/UrbanReflex.git
cd UrbanReflex
docker-compose up -d

# Access
Frontend: http://localhost:3000
API: http://localhost:8000
Docs: http://localhost:8000/docs

Demo Accounts: admin@urbanreflex.dev / Admin@123456 | citizen@urbanreflex.dev / Citizen@123456

🐛 Known Limitations

  • Map limited to 1000 markers, first load 5-10s
  • No real-time notifications, email/SMS, mobile app, or offline mode
  • Mock data fallback, 30-day historical limit
  • Single-instance only, no auto-scaling or backups
  • Optimized for Chrome/Edge/Firefox (Safari issues, no IE11)

🔧 Tech Stack

Backend: FastAPI, MongoDB, Orion (NGSI-LD), Redis, Gemini AI, Pinecone | Frontend: Next.js 16, React 19, TypeScript, Tailwind CSS, MapLibre GL | Infra: Docker Compose

⚠️ Notice

Beta release for testing only. Not production-ready. APIs may change. Wait for v0.1.0 stable.

📞 Support

Docs | Issues | Discussions | support@urbanreflex.dev

Loading