changemaker.lite/mkdocs/docs/v1/index.md

V1 Documentation (Deprecated)

!!! warning "V1 is Legacy" Changemaker Lite V1 is deprecated and no longer actively maintained. These docs are preserved for reference only.

Migrating to V2

Changemaker Lite V2 is a complete architectural rebuild with significant improvements:

A quick test because why not.

Why Upgrade to V2?

Modern Stack

• TypeScript throughout (V1 was JavaScript)
• Prisma ORM (V1 used NocoDB REST API)
• JWT auth (V1 used session cookies)
• React admin (V1 used server-rendered HTML)

Better Performance

• Direct database access (no NocoDB middleware)
• Redis-backed caching and rate limiting
• BullMQ job queues for async operations
• Optimized queries with Prisma

Enhanced Security

• Security audit completed (Feb 2026)
• Password policy enforcement (12+ chars, complexity)
• Refresh token rotation in transactions
• XSS/injection prevention throughout
• Rate limiting on all sensitive endpoints

New Features

• Volunteer canvassing system with GPS tracking
• Landing page builder (GrapesJS)
• Email template management
• Media library (video management)
• Observability dashboard (Prometheus + Grafana)
• NAR 2025 data import (Canadian electoral data)

View complete V2 documentation →{ .md-button .md-button--primary }

Migration Guide

Ready to migrate? Follow our step-by-step guide:

→ V1 to V2 Migration Guide{ .md-button }

The migration guide covers:

1. Breaking Changes - NocoDB → Prisma, API endpoint changes
2. Data Migration - Export V1 data, transform, import to V2
3. Configuration Changes - Environment variables, service names
4. Feature Parity - V1 vs V2 feature comparison

V1 Documentation Archive

These docs are preserved for existing V1 installations:

Build Guides

• Build Overview
• Build Server
• Build Map
• Build Influence
• Build Site

Services

• Services Overview
• Homepage
• Code Server
• MKDocs
• Listmonk
• PostgreSQL
• n8n
• NocoDB
• Gitea
• Map
• Mini QR

Configuration

• Config Overview
• Cloudflare
• MKdocs
• Code Server
• Map

Manuals

• Manual Overview
• Map Manual

Advanced

• Advanced Overview
• SSH + Tailscale + Ansible
• SSH + VScode

V1 Architecture (Reference)

V1 used a two-app architecture with NocoDB as the data layer:

Influence App (port 3333)

• Express.js server with server-rendered HTML
• NocoDB REST API for database operations
• Session-based authentication (Redis)
• Bull job queues for emails

Map App (port 3000)

• Express.js server with Leaflet.js maps
• NocoDB REST API for database operations
• QR code generation
• Volunteer shift management

Shared Infrastructure

• NocoDB (data layer)
• Redis (sessions, cache, queues)
• PostgreSQL (via NocoDB)
• Cloudflare tunnels

Support for V1

V1 is no longer under active development. We recommend migrating to V2.

For critical V1 issues:

• Check existing V1 documentation
• Review V1 code in /influence and /map directories
• Consider migrating to V2

---

Ready to upgrade? Start with the V2 Quick Start Guide →