Important
In development — CareStickers is still in active development. So there might be features, APIs, and hosting changes before a stable release. We will protect your privacy with the application storage and never share any details to third parties or internally unless you are providing bug information.
Tip
Support development — CareStickers is still in active development. If the app helps you or your whānau, you can help fund ongoing work if you would like to support a solo team consider using:
Welcome to CareStickers, this is a social self-care tracking app: set personal and community goals, earn stickers, share progress with friends, and stay motivated together. You can be part of a team or a team admin for your friends or family.
- Personal & global goals — self-care tasks plus community-wide global goals
- Daily challenges — admin-promoted goals for all users
- Stickers — visual rewards for completed goals
- Social — invites, high-fives, and shared progress
- Groups — join via invite codes; creators get a Group Admin role
- Admin portal — manage community goals, track progress, search users
- Multi-auth — email/password, magic link, Google, and Apple (Supabase Auth)
- Onboarding — interactive tutorial for new users
Prerequisites: Node.js 20+, a Supabase project (or local Postgres via Docker).
npm install
cp .env.example .env # configure API + Vite vars
npx supabase login
npx supabase link --project-ref <SUPABASE_PROJECT_ID>
npm run db:push
npm run dev # SPA :3000, API :3001Production: npm run build then npm start. See docs/DEVELOPMENT.md for env vars, scripts, and testing.
| Doc | Contents |
|---|---|
| docs/ARCHITECTURE.md | Stack, component diagram, project layout, routing |
| docs/DEVELOPMENT.md | Configuration, npm scripts, testing |
| docs/DEPLOYMENT.md | Production, Docker, GHCR |
| docs/SUPABASE.md | Linking, auth providers, local stack, migrations CI |
| docs/MOBILE_RELEASE.md | Capacitor builds, OAuth, push, store submission |
| docs/AWS_DEPLOYMENT_PLAN.md | Proposed AWS test environment (not provisioned) |
React 19 · Vite · Tailwind · Express · Supabase (Postgres, Auth, Realtime, Storage) · Capacitor for iOS/Android. One container image serves the API and static SPA.
Identities and sessions are managed by Supabase Auth; the API verifies JWTs (JWKS) and enforces access server-side. Keep SUPABASE_SECRET_KEY, database credentials, and provider secrets in .env only — never in the repo or client bundle. See docs/SUPABASE.md S8.
See SPDX headers in source files where applicable (e.g. App.tsx).