Contribute

TrocOS is open source and community-driven. Issues, merge requests, and ideas are all welcome.

Repository: gitlab.com/cdlr75/trocos

Stack

• Rails 8 — web framework
• PostgreSQL — database
• Bulma — CSS framework
• Hotwire (Turbo + Stimulus) — reactive UI without a JS framework
• Solid Queue — background jobs
• OmniAuth — GitHub, Discord, Slack sign-in
• Pundit — authorization
• double_entry — time bank ledger

Running locally

git clone https://gitlab.com/cdlr75/trocos.git
cd trocos
bin/setup

Start PostgreSQL (Docker):

docker run -d --name trocos_postgres \
  -e POSTGRES_USER=trocos \
  -e POSTGRES_PASSWORD=trocos \
  -e POSTGRES_DB=trocos_development \
  -p 5432:5432 postgres:16

bin/rails db:create db:migrate db:seed
bin/rails trocos:setup
bin/dev

Running tests

bin/rails test

Contributing

1. Fork the repo on GitLab
2. Create a branch for your change
3. Write tests for new behavior
4. Open a merge request with a clear description

For significant changes, open an issue first to discuss the approach.