Add a Project
Help grow the UK civic tech ecosystem by adding projects to the directory. We accept both open-source and closed-source projects.
How it Works
Open Source Projects
Submit a pull request to our GitHub repository. We'll automatically scrape your GitHub repo for metadata like stars, activity, and README.
Minimum required: name, url, github, category, description
Closed Source Projects
Submit via PR with your project details. A community member must vouch for the project, and we'll verify it has a legitimate public presence.
Required: name, url, category, description, contact, submitted_by
Submission Format
# Open Source Project
- name: "Your Project Name"
url: "https://yourproject.org"
github: "https://github.com/org/repo"
category: ["transparency", "democracy"] # Choose from existing categories
type: "open" # open | closed | mixed | org | gov
status: "active" # active | maintained | dormant | archived
description: "One-line description of what your project does"
founded: 2024
tags: ["parliament", "voting", "data"]
looking_for: # Optional - list what help you need
- "Frontend developers"
- "Data contributors"
contact: "@yourhandle"
# Closed Source Project
# TODO: Add real example when we have closed-source projects listed
# - name: "Private Initiative"
# url: "https://example.com"
# category: ["policy-analysis"]
# type: "closed"
# status: "active"
# description: "Description of the project"
# submitted_by: "@communityMember" # Required for closed source
# contact: "[email protected]"Available Categories
policy-analysis Policy tools, research platforms
democracy Democratic participation tools
transparency FOI, accountability, spending
electoral Election data, voting tools
local Hyperlocal civic tools
services NHS, education, transport
economic Fiscal policy, economic analysis
civic-ai AI-powered civic tech
Inclusion Criteria
✓ What We Accept
- ✓ Tools that improve democratic participation
- ✓ Resources that increase government transparency
- ✓ Platforms that help citizens engage with policy
- ✓ Analysis that informs public debate
- ✓ Infrastructure that benefits the civic ecosystem
✗ What We Don't Accept
- ✗ Partisan campaign tools
- ✗ Commercial products without civic benefit
- ✗ Foreign influence operations
- ✗ Projects without public presence
- ✗ Spam or promotional content
Add a WhatsApp Group for Your Project
Want a WhatsApp group for your project's community? We can add it to the Community page. Links are stored securely and never appear in source code.
How it works
- Create a WhatsApp group for your project
- Enable "Admin approval for new members" in group settings
- Get your group's invite link (Settings → Invite via link)
- Contact @laurencepostrv on X with your project name and link
- We'll add the slug to the codebase and set the secret
Security notes
- ✓ Links stored as encrypted secrets in Cloudflare
- ✓ Never committed to source code or Git history
- ✓ Rate-limited API prevents bulk scraping
- ✓ You control group membership via WhatsApp admin tools
- ! Links can be rotated anytime if compromised
For maintainers: Use the management script to add new groups:
# Add a new group slug to the codebase
npx tsx scripts/manage-whatsapp.ts add my-project
# Get the wrangler command to set the secret
npx tsx scripts/manage-whatsapp.ts set my-project
# List all known groups
npx tsx scripts/manage-whatsapp.ts listRequest Delisting
Project maintainers can request removal of their project from the directory. We respect your right to opt out.
How to Request Removal
- Open a delisting request on GitHub
- Provide verification of project ownership (e.g., post from official account, email from project domain, or link to your GitHub profile if you're a maintainer)
- We'll verify and process your request within 48 hours
Note: We only accept delisting requests from verified project maintainers or representatives. This prevents bad actors from removing legitimate projects.
Ready to Contribute?
Submit a pull request to add your project, or open an issue if you need help.