Skip to content

Change Maker Simple Button

Transform any website into a powerful catalyst for change with our seamless, one-click solution.

Free. Open. Built by activists, for activists.

Simple Button

Empower your community with zero technical hassle.

📧

Direct Impact

Real emails that work

⚡

Instant Setup

From idea to action in minutes

🔒

Privacy First

Your data stays yours

💝

Always Free

No hidden costs

🤝

Community Built

By organizers, for organizers

🌐

Instant Pages

Built-in landing pages

🔌

Embed Anywhere

Works on any website

🛟

Ongoing Support

Community backed help

👩‍💻

Open Code

Transparent & secure

Live Demo

Why Use Simple Change Button?

  • ✨ Free Forever - No hidden costs, no premium features
  • 🚀 5-Minute Setup - From zero to action in minutes
  • 📧 Real Impact - Emails come from real people's accounts
  • 🔒 Privacy First - No invasive tracking of users
  • 💪 Community Owned - Built by organizers, for organizers

Install Simple Change Button on your website and start making a difference today!

Installation Guide

Simple Change Button is a self-hosted tool that requires Docker & Docker Compose to run. Follow these steps to get started:

Install Docker & Docker Composer

Docker Installation Instructions

Releases of the latest version of Simple Change Button are released with the newsletter. To get the latest version, subscribe to the newsletter below:

Subscribe

Or you can email the admin directly and request access:

Install

Independent Installation

Download and Unzip the Latest Release

Update .env Files

In the Simple Change Button directory, update the .env files with your desired settings. Theese two files can be found in the backend and frontend directories.

.frontend/.env

REACT_APP_API_URL=http://localhost:5000
REACT_APP_PRODUCTION_URL=https://button.bnkops.com // Change this to your domain
NODE_ENV=development // change to production for production
PORT=5001

.backend/.env

JWT_SECRET=your-very-secure-and-very-long-secret-key-here // Change this to a secure key
MONGODB_URI=mongodb://127.0.0.1:27017/emailcounter
PORT=5000
NODE_ENV=development // change to production for production
CORS_ORIGIN=http://localhost:5001

Run docker-compose up in the Simple Change Button directory.

Your Simple Change Button instance will be available at http://localhost:5001 in your browser.

Install With Changemaker

If you are using Changemaker, you can install Simple Change Button during installation.

Run ./start.sh in the root directory and select Simple Change Button from the list of available tools.

First Open

On first open, you will be prompted to create an admin account. Fill in the details and click "Create Account". You will then be redirected to the dashboard.

Quick Start

  1. Create a button in the dashboard
  2. Copy the embed code
  3. Paste it anywhere on your site
  4. Track real engagement

Dashboard

alt text

The dashboard is where you can create, manage, and track your buttons. You can also manage users and view statistics.

Dashboard Features

  • Total emails sent
  • Per-button metrics
  • Usage trends
  • Real-time statistics
  • Export capabilities
  • User Management

Analytics

alt text

Analytics are available in real-time and provide insights into button performance. You can also export data for further analysis.

User Management

alt text

User management allows you to add, remove, and edit user accounts. Future updates will include assign roles and permissions to users.

Creating a Button

alt text

  1. Log into admin dashboard
  2. Click "Create New Button"
  3. Fill in button details
  4. Optional: Add CC/BCC
  5. Save and get embed code

Editing a Button

alt text

Buttons are listed according to time of creation and can be edited at any time. You can change the button text, email body, and other settings.

Standalone Button Page

alt text

All buttons also generate a standalone page that can be shared directly. This page includes the button, email body, and other details. Useful for sharing on social media or in emails.

Privacy & Security

  • No personal data collection
  • GDPR-compliant design
  • Encrypted connections
  • Local data storage only

Deployment

Bnkops uses Cloudflare for secure, fast, and reliable hosting. You can also deploy Simple Change Button on your own server.

We have instructions for deployment through Cloudflare for the whole Changemaker suite.

Cloudflare Deployment

However, you can also deploy Simple Change Button independently. Here is a sample configuration file for Cloudflare Tunnel:

Cloudflare Tunnel Configuration

tunnel: [YOUR-TUNNEL-ID]
credentials-file: [path-to-credentials-file]
ingress:
  - hostname: [button.your-domain.com]
    service: http://localhost:5001
  - service: http_status:404

Best Practices

Design Recommendations

  • Keep email body concise
  • Use clear call-to-action text
  • Test buttons before deployment
  • Monitor performance regularly

Troubleshooting

Common Issues

Button not tracking:

  • Check internet connection
  • Verify proper embedding
  • Clear browser cache

Stats not updating:

  • Refresh dashboard
  • Check server connection
  • Verify permissions

Support

Contact system administrator for:

  • Technical issues
  • Feature requests
  • Account problems
  • General assistance

Built with ♥️ by communities, for communities