Goose
A planning and tracking app for technical and consulting work: goals, projects, tasks and the people behind them.
It grew out of a prototype (in public/prototype/) and is now being built as a real web app.
- Strategy → Projects → Tasks: goals and sub-goals, fixed-term and ongoing projects, tasks with assignees.
- Timeline of every project as a lane, Review for any date range, Insights charts.
- Teams and access levels: Admin, Manager, Member, Guest. Each person sees only what they are part of.
- Workspaces: sign up and work on your own, or be invited into a colleague's workspace.
How it is built
| Part | Choice | Why |
|---|
| Web app | React + TypeScript (Vite) | Standard, fast, easy to host anywhere |
| Database, logins, files | Supabase (Postgres, EU region) | Email sign-in and invitations built in; row-level security enforces who sees what |
| Hosting | GitHub Pages | Free, published automatically on every push to main |
The visibility rules live in the database (supabase/migrations), not in the page: the browser never receives data a person may not see. See docs/architecture.md and docs/teams-and-access.md.
Status
Phase 1 (foundation) is under way. Working now: sign-in by email link, personal workspaces, accepting invitations, Projects, Tasks and Team (invite) screens. Timeline, Strategy, Review and Insights are being moved over from the prototype. See docs/roadmap.md.
Setting it up
You need Node.js 20 or newer and a free Supabase account.
- Create the Supabase project. At supabase.com create a new project; pick an EU region (Goose uses Ireland, eu-west-1).
- Create the database. In the project's SQL Editor, paste the contents of
supabase/migrations/20261023000000_init.sql and run it.
- Allow sign-in links back to the app. In Authentication → URL Configuration, set the Site URL to
http://localhost:5173 while developing (later, your real domain).
- Connect the app. Copy
.env.example to .env.local and fill in the Project URL and the anon public key from Project Settings → API.
- Run it.
npm install
npm run dev
Open http://localhost:5173, enter your email, and click the link you receive. Your personal workspace is created on first sign-in.
Testing the security rules
supabase/tests/access_rules.sql signs in as an admin, a member, a guest, a manager and an outsider, and checks what each can see and change. It runs automatically on every push (GitHub Actions, see .github/workflows/ci.yml). To run it locally against a plain Postgres 16:
psql -f supabase/tests/stub_supabase.sql
psql -f supabase/migrations/20261023000000_init.sql
psql -f supabase/tests/access_rules.sql # ends with "ALL ACCESS TESTS PASSED"
Website
The public website (Overview, Features, Why Goose, Security, FAQ) is in website/.
Name and look
The app is called Goose (APP_NAME in src/config.ts, <title> in index.html). The default palette is Goose feather: near-black top bars, warm white content, beak-orange actions and yolk-yellow highlights. The other palettes (Golden meadow, Forest calm, Evening glow, Coastal breeze) are in src/styles.css. The preliminary logo is the goose in public/ (goose.png on its own, goose-tile-*.png on a warm white square for the dark top bar and app icons), used through src/components/Logo.tsx.
