Changemaker Lite

Changemaker Lite is a streamlined documentation and development platform featuring essential self-hosted services for creating, managing, and automating political campaign workflows.

Features

• Homepage: Modern dashboard for accessing all services
• Code Server: VS Code in your browser for remote development
• MkDocs Material: Beautiful documentation with live preview
• Static Site Server: High-performance hosting for built sites
• Listmonk: Self-hosted newsletter and email campaign management
• PostgreSQL: Reliable database backend
• n8n: Workflow automation and service integration
• NocoDB: No-code database platform and smart spreadsheet interface
• Map: Interactive map visualization for geographic data with real-time geolocation, walk sheet generation, and QR code integration

Quick Start

The whole system can be set up in minutes using Docker Compose. It is recommended to run this on a server with at least 8GB of RAM and 4 CPU cores for optimal performance. Instructions to build to production are available in the mkdocs/docs/build directory, at cmlite.org, or in the site preview.

# Clone the repository
git clone https://gitea.bnkops.com/admin/changemaker.lite
cd changemaker.lite

# Configure environment (creates .env file)
./config.sh

# Start all services
docker compose up -d

Map

Instructions on how to build the map are available in the map directory.

Instructions on how to build for production are available in the mkdocs/docs/build directory or in the site preview.

Quick Start for Map

Update the .env file in the map directory with your NocoDB URLs, and then run:

cd map
docker compose up -d

Service Access

After starting, access services at:

• Homepage Dashboard: http://localhost:3010
• Documentation (Dev): http://localhost:4000
• Documentation (Built): http://localhost:4001
• Code Server: http://localhost:8888
• Listmonk: http://localhost:9000
• n8n: http://localhost:5678
• NocoDB: http://localhost:8090
• Map Viewer: http://localhost:3000

Production Deployment

If you are deploying to production, using Cloudflare, you can use the included 'start-production.sh' script to set up a secure deployment with HTTPS. Ensure your domain and cloudflare settings are correctly configured in the root .env before running. More information on the required API tokens and settings can be found in the mkdocs/docs/build directory or at cmlite.org.

./start-production.sh

Documentation

Complete documentation is available in the MkDocs site, including:

• Service configuration guides
• Integration examples
• Workflow automation tutorials
• Map application setup and usage
• Troubleshooting guides

Visit http://localhost:4000 after starting services to access the full documentation.