turbo-expo-nextjs-clerk-convex-monorepo

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

turbo-expo-nextjs-clerk-convex-monorepo

★ 393 Open GitHub ↗

Monorepo template with Turborepo, Next.js, Expo, Clerk, Convex

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Fullstack Monorepo Template

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

It currently uses:

- [Turborepo](https://turbo.build/repo)
- [pnpm](https://pnpm.io/)
- [Next.js 16](https://nextjs.org/) with the App Router
- [Expo SDK 55](https://docs.expo.dev/) with Expo Router
- [React 19](https://react.dev/)
- [Convex](https://convex.dev/)
- [Clerk](https://clerk.com/)
- [OpenAI](https://platform.openai.com/docs/quickstart?api-mode=responses) 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

```sh
pnpm install
```

### 2. Configure Convex

Run the backend setup command:

```sh
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](https://docs.convex.dev/auth/clerk).

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

```sh
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:

```sh
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

```sh
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:

```sh
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:

```sh
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`

turbo-expo-nextjs-clerk-convex-monorepo

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README