TinyCongress

This is a non-functional WIP monorepo for a web community.

Website: tinycongress.com | Landing Page Repo: tiny-congress-landing

Core Components

• /web/
  • A simple React UI will offer allow users to create accounts, manage keys and participate in polling rooms. Mantine UI has been picked for the component library.
• /service/
  • A Rust based graphql API implements polling room runtime and CRUD endpoints. axum, tokio, and sqlx.

Dev

Skaffold manages:

• Local dev cluster with hot reload
• CI cluster setup test running
• Production image building

macOS Developer Setup

This guide gets you from a clean macOS to running TinyCongress locally.

Prerequisites

• macOS 13+ (Apple Silicon or Intel)
• Admin user

Install Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Follow on-screen PATH instructions (usually add to ~/.profile)

Core tooling

brew install git gnupg jq shellcheck
brew install --cask docker
brew install kubectl minikube skaffold

• Open Docker Desktop once to finalize installation.

Start dev cluster

minikube start
skaffold dev --port-forward

Documentation

See docs/README.md for playbooks, interfaces, ADRs, and documentation placement rules.