If you use the Citizen OS open source code, please let us know: info@citizenos.com! <3 We are mostly interested in the usage statistics. Perhaps you can open the stats for us?

Citizen OS is a free participation platform for collaborative text creation, structured discussion and voting. Read about the newest developments on our news page: https://citizenos.com/news/.

:dart: Features

• Private and public topics, private groups. Public groups planned - https://github.com/orgs/citizenos/projects/1#card-14133727
• e-ID log-in and vote signing
• Science-led structured argumentation environment
• vote delegation, minivote, multiple choices votes
• bottom-up empowerment
• Independently funded by a sustainable NGO
• GDPR compliant
• Multi-platform UI
• activity feed
• Community moderation
• Translated in 14 languages
• And much more, explore Citizen OS

:bulb: Philosophy

The Citizen OS Foundation is a civic tech non-profit organisation based in Tallinn, Estonia.

Our mission is “to empower as many people as possible to participate in respectful, meaningful discussions in order to collaboratively decide on issues that affect their wellbeing."

The main focus of the Citizen OS Foundation is our collaborative decision-making platform for civic initiatives, which is provided free of charge to anyone who wants to use it. The online platform allows for deliberative discussions, collaborative decision-making and voting in situations where it is either impossible or inconvenient for participants to be in the same room.

In Estonia, where a national e-ID system is in place, the Citizen OS platform is also used in situations when a large number of people need to digitally sign a single document, such as people's initiatives, petitions, housing associations agreements and NGO general meetings. Documents signed using the Citizen OS platform are accepted by all levels of government, including the Riigikogu (Estonia’s Parliament) and the national Commercial Register.

We listen to our users in issues.

:gear: Running

:book: Prerequisites

• Node.JS >= 10.22.1 (https://github.com/mklement0/n-install)

:book: Installing

• Get the source - git clone git@github.com:citizenos/citizenos-fe.git
• Go to the source directory - cd citizenos-fe
• DEV ONLY Add to dev.citizenos.com to your hosts file - sudo -- sh -c -e "echo '127.0.0.1 dev.citizenos.com' >> /etc/hosts"
• DEV ONLY When using over HTTPS you need to add ./config/certs/citizenosCARoot.pem to your trusted CA certificate store or browsers will complain.

:book: Running

• Set NODE_ENV environment variable:
  • Production - production
  • Test - test
  • Development/local - development
• Run the application:
  • Production/test - node ./bin/www. Note that Heroku and some other cloud envs pick up the starting point from Procfile (https://github.com/citizenos/citizenos-fe/blob/master/Procfile.txt)
  • Development - npm run dev (optionally could add an ip address to serve externallynpm run dev -- --host 192.168.56.101 )
• Open
  • Production/test - your configured public app url.
  • Development - https://dev.citizenos.com:3001 or http://dev.citizenos.com:3000 in your browser.

NOTES:

• By default the app runs against CitizenOS public development environment (https://development.api.citizenos.com). If you want to run against your local citizenos-api instance, modify the url in app.js to https://dev.api.citizenos.com:3003

:thumbsup: Contributing

https://github.com/citizenos/citizenos-api/wiki/Development-guidelines

Pull requests

• All pull requests to development branch
• Translations and live-ready code in masterbranch
• Live site runs on prod branch
• All the other ways to contribute - https://citizenos.com/get-involved/