Skip to main content

Welcome to CivicOS

CivicOS is a public platform that lets citizens raise problems, sign petitions, follow their elected representatives, 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.

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, and progress updates.

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.

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.

What CivicOS is not​

  • Not a replacement for the ballot box. Elections still matter — CivicOS is what happens between them.
  • Not anonymous. Comments, upvotes, signatures, and reports are all tied to a verified account. Anonymity works against accountability.
  • 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 →