Fullstack Monorepo Template

This repo is a modern TypeScript monorepo for a shared notes app across web and native.

It currently uses:

• Turborepo
• pnpm
• Next.js 16 with the App Router
• Expo SDK 55 with Expo Router
• React 19
• Convex
• Clerk
• OpenAI for optional note summaries

What’s inside

• apps/web - the Next.js web app
• apps/native - the Expo native app
• packages/backend - the Convex backend and generated API types

Quick start

1. Install dependencies

pnpm install

2. Configure Convex

Run the backend setup command:

pnpm --filter @packages/backend setup

This will log you into Convex, create or connect a project, and generate packages/backend/.env.local.

3. Configure Clerk for Convex

Follow the official Convex + Clerk guide.

In the Clerk dashboard, enable the Convex integration and copy the Clerk JWT issuer domain. Add it to your Convex environment variables as:

CLERK_JWT_ISSUER_DOMAIN=https://your-frontend-api.clerk.accounts.dev

If you want native social login, enable Google and Apple in Clerk as well.

If you want AI summaries, also add:

OPENAI_API_KEY=...

to your Convex environment variables.

4. Configure the app env files

Create .env.local files in apps/web and apps/native from the provided .example.env files.

• Use CONVEX_URL from packages/backend/.env.local for both NEXT_PUBLIC_CONVEX_URL and EXPO_PUBLIC_CONVEX_URL
• Use your Clerk publishable key for both app env files
• Use your Clerk secret key in apps/web/.env.local

5. Run the apps

pnpm dev

This runs the backend, web app, and native app through Turbo.

Deploying

From apps/web, use Convex to deploy the backend and build the web app:

cd ../../packages/backend && pnpm exec convex deploy --cmd 'cd ../../apps/web && pnpm build' --cmd-url-env-var-name NEXT_PUBLIC_CONVEX_URL

apps/web/vercel.json is already set up for this flow on Vercel.

Adding dependencies

Install dependencies in the package that actually uses them.

Examples:

pnpm --filter web-app add mypackage@latest
pnpm --filter native-app add mypackage@latest
pnpm --filter @packages/backend add mypackage@latest

Notes

• The native app uses Expo Router route groups under apps/native/src/app
• The web app protects note routes with apps/web/src/proxy.ts
• Convex enforces note ownership server-side in packages/backend/convex/notes.ts