Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WaveTap

Wave. Tap. Book.

Peer-to-peer platform connecting Deaf and Hard of Hearing individuals with Auslan interpreters. No agencies, no middlemen — just match, then hand off. Australia · wavetap.app

A neutral aggregator: we connect signers and interpreters, then step aside. All coordination, invoicing, and payment happens off-platform between the two parties.

Documents

Read these in order. Each builds on the previous.

# Document Description
01 Project Overview Vision, principles, what WaveTap is and isn't
02 User Roles & Profiles Signer and Interpreter roles, dual-role accounts, profile fields
03 Booking Flow The complete lifecycle: Wave → Tap → Book
04 Tech Stack Architecture, infrastructure, cost projection
05 Data Model Database schema, tables, RLS, indexes
06 Auth, Security & Privacy Magic link, privacy principles, account deletion, ToS
07 Admin Panel Moderation tools, analytics dashboard, audit log
08 Accessibility WCAG 2.1 AA + Deaf-specific UX principles
09 Design System Colours, typography, spacing, components, brand voice
10 Notifications Channels, events, templates, dispatch logic
11 Routes & Pages All application routes, navigation, page structure

Quick Reference

  • Clients: Responsive web (Next.js) + native iOS & Android (Expo), built simultaneously
  • Monorepo: pnpm + Turborepo — apps/web, apps/mobile, shared packages/*
  • UI: HeroUI — @heroui-pro/react (web) + heroui-native (mobile), one design language
  • Backend: Supabase (PostgreSQL + RLS, Auth, Realtime, Edge Functions, Storage)
  • Auth: Magic link (passwordless)
  • Hosting: Vercel (web) + EAS / App Store + Google Play (native)
  • Notifications: Resend (email) + Expo Notifications (native push)
  • Language: Auslan (multi-language infrastructure)
  • Geography: Australia
  • Domain: wavetap.app

Repository & Development

pnpm + Turborepo monorepo:

apps/
  web/      Next.js 15 + React 19 + Tailwind v4 (HeroUI Pro) — also hosts the admin panel
  mobile/   Expo (React Native) + heroui-native            — iOS & Android
packages/
  tokens/   shared design tokens (→ regenerate from design-tokens/ when it lands)
  core/     platform-agnostic domain types + logic
  api/      typed Supabase client factory
  config/   shared tsconfig / prettier
supabase/   migrations, RLS, Edge Functions
pnpm install          # install all workspaces
pnpm web              # run the web app (apps/web)
pnpm build            # build everything via Turborepo

Before the web app uses HeroUI Pro components, run the Pro CLI (needs your GitHub login):

npx heroui-pro login && npx heroui-pro install
# then uncomment the @heroui/styles + @heroui-pro/react/css imports in apps/web/app/globals.css

Copy .env.exampleapps/web/.env.local (and apps/mobile/.env) and fill in values. See 04_TECH_STACK.md.

For AI-assisted development

These documents are designed to be loaded as project context (Cursor, Claude Code, etc.). When starting a new feature or component:

  1. Reference the relevant doc(s) for requirements
  2. Follow the design system tokens for all UI work — they are shared across web and native
  3. Seed UI from HeroUI via the HeroUI MCP (@heroui-pro/react on web, heroui-native on mobile), then refine against the design system and accessibility docs
  4. Follow the data model for any database interactions
  5. Follow the accessibility checklist before shipping — on web and native
  6. Follow the booking flow states for any booking-related logic
  7. Put platform-agnostic logic in packages/core / packages/api so both clients share it

The docs are the source of truth. If the code diverges from the docs, update one or the other — don't let them drift.


GitHub repo description (paste into AboutDescription):
Peer-to-peer platform connecting Signers with Auslan interpreters. Wave. Tap. Book. — wavetap.app

About

Peer-to-peer platform connecting Deaf/HoH with Auslan interpreters. Wave. Tap. Book.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages