Local development

Fellesly is a pnpm monorepo on Node 22.

Path	What
apps/api	Fastify API (TypeScript)
apps/app	Expo (React Native + react-native-web): iOS, Android, web
apps/site	Marketing site (static)
apps/docs	This documentation (VitePress)
packages/shared	Zod schemas and types shared by API and app
packages/design	Design tokens

pnpm install
pnpm dev:api   # http://localhost:3000; without DATABASE_URL data lives in memory
pnpm dev:app   # Expo; press w for web, i for the iOS simulator
pnpm --filter @fellesly/docs dev   # these docs on http://localhost:5173

The app talks to EXPO_PUBLIC_API_URL (default http://localhost:3000). A first visit with no session seeds a demo family.

Checks

pnpm format:check && pnpm typecheck && pnpm test && pnpm build:web

pnpm test runs the API test suite, the design-token freshness check, the marketing site check and a docs build.

Native builds

Expo Go runs most of the app. Google/Apple sign-in, the share extension and push need a development build (npx expo run:ios / run:android) with your own signing identity.