Welcome to CivicOS

CivicOS is a public platform that lets citizens raise problems, sign petitions, follow their elected representatives, answer consultations, fund local work, and see what actually gets done — between elections, not just during them.

This documentation covers everything you can do inside CivicOS. Whether you're a citizen filing your first report, an organization admin managing announcements, an elected representative responding to your constituents, or a developer contributing to the codebase — pick your path below.

Who this documentation is for

For citizens

You want to raise an issue, sign a petition, follow your rep, or comment publicly on what's happening in your community.

• Start with Create an account.
• Then Join your community.
• Learn how to report an issue, how voting works, and how to manage your notifications.
• Have your say on a consultation, or donate to a campaign an organization is running near you.
• See what CivicAI does — and, more usefully, what it is not allowed to do.

For organization admins

You represent an NGO, agency, government body, or utility on CivicOS. You want to post announcements, run projects, take responsibility for citizen-reported issues, and post progress updates publicly.

• Read Managing organizations — one page covering members, announcements, projects, assignments, progress updates, fundraising campaigns, and your funding analytics.
• Read Running consultations if you need structured input before making a decision.
• Read CivicAI for organizations for the drafting tools, and what they will and will not write for you.

For representatives

You're an elected official. You want to respond to constituents, answer questions on your public page, and manage the accountability metrics that voters look at.

• Read the Representative dashboard guide.

For developers

You're building on, deploying, or contributing to CivicOS.

• Head to the Developer Guide — architecture, monorepo layout, per-service pages, database, events, contributing, deployment.
• Or dive straight into the API reference — interactive Swagger UI, one spec per service.

For decision makers evaluating CivicOS

You're a policy team, a procurement lead, or a program manager deciding whether CivicOS fits your community.

• Read Why CivicOS? for the problem statement and vision.
• Read What is CivicOS? for the shape of the platform.
• Read Core Principles for what we build and what we refuse to.
• Read the Roadmap for what's shipped, next, and aspirational — no hype.

What CivicOS is not

• Not a replacement for the ballot box. Elections still matter — CivicOS is what happens between them.
• Not anonymous — except when you give. Comments, upvotes, signatures and reports all carry your name. Donations do not have to: you can give to a campaign without appearing publicly.
• Not holding your donation. Money you give goes straight to the organization's own bank account. CivicOS records what happened; it does not hold, release, or guarantee the funds.
• Not a complaint hotline. Issues you report are public and go on the record, so they can be tracked and resolved openly.

Everything is on the record

Every action you take is recorded on a public register. When a representative or agency responds to an issue you filed, you get a notification. When someone signs a petition you started, you get a notification. When an admin hides content, that decision is logged too — so moderation stays reviewable.

Ready? Create your account →