Mobile Project Structure

Understand the mobile app and its place in the monorepo

Shared Monorepo Structure

EasyStarter is a pnpm workspace monorepo managed by Turborepo.

apps/
  web/        Web client
  native/     Mobile client
  server/     Hono API on Cloudflare Workers
  config-ui/  Internal configuration tool
packages/
  app-config/ Shared business configuration
  api-client/ Shared API client contracts
  i18n/       Shared locale resources
  shared/     Cross-platform utilities and types

Shared Design Rules

Backend capability lives in apps/server
Cross-platform configuration stays in packages/*
Web and Mobile each keep their own UI and navigation
Shared business rules should not be duplicated between clients

Mobile Areas

Focus on these folders when working on the app client:

apps/native/
  app/ or src/    Screens and navigation
  components/     Mobile UI components
  hooks/          App-facing hooks
  lib/            Client helpers

Typical Mobile Work

building native screens
wiring device capabilities
handling deep links
consuming shared backend capability from the app

Mobile Getting Started

Run the Expo app locally

Configure app.json

First step — replace EasyStarter's template identifiers with your own app info

On this page

Mobile Areas Typical Mobile Work