Universal Template

A production-ready monorepo template for building full-stack applications with React Native, Next.js, and Hono. Cloudflare Workers deployment is preconfigured through vinext and Wrangler without replacing the normal Next.js and Node development/deployment paths.

🚀 Features

Core Stack

Mobile App: React Native with Expo SDK 56 development builds and New Architecture enabled
Web App: Next.js 16 with App Router, React Server Components, tRPC, auth, and an optional vinext Workers build
Secondary Server: Portable Hono database example and health service
Hosting: Cloudflare Workers with Wrangler and one GitHub Actions deployment pipeline
Type Safety: End-to-end type safety with TypeScript and tRPC
Monorepo Management: Turborepo with pnpm workspaces for optimized builds

Authentication & Security

Better Auth: Complete authentication system with:
- Email/password authentication
- Phone number authentication via Twilio OTP
- Google OAuth integration
- Email verification
- Password reset flows
Firebase Integration: Native push notifications, token registration, and App Check

Styling & UI

Mobile: NativeWind v5 with theme provider
Web: Tailwind CSS v4 with Shadcn/ui

Data & State Management

Database: Prisma v7 ORM with PostgreSQL/Supabase
Server State: TanStack Query (React Query) via tRPC
Client State: Zustand for local state management

Monetization & Analytics

Web Payments: Direct Stripe subscriptions managed by Better Auth
Mobile Subscriptions: RevenueCat over App Store and Play Billing
Independent Billing: Stripe and RevenueCat remain separate while backend routes accept either verified entitlement
Analytics: PostHog for product analytics
Error Tracking: Sentry for monitoring

Developer Experience

Type Safety: Shared TypeScript configurations
Code Quality: Type-aware Oxlint, Prettier, Husky pre-commit hooks

Mobile-Specific Features

Push Notifications: Firebase Cloud Messaging
Permissions: Camera, notifications, location handling
Device Info: Platform-specific utilities
App Store Ready: EAS Build & Submit configured

📁 Project Structure

.
├── apps/
│   ├── native/          # Expo React Native app
│   │   ├── app/         # App screens and navigation
│   │   ├── assets/      # Images and static files
│   │   ├── config/       # Firebase credentials
│   │   └── eas.json     # EAS Build configuration
│   ├── server/          # Portable Hono database example and health server
│   │   └── src/         # Server source code
│   └── web/             # Next.js web app
│       ├── app/         # App Router pages
│       └── components/  # React components
├── packages/
│   ├── api/             # tRPC router definitions
│   ├── auth/            # Better Auth configuration
│   ├── db/              # Prisma schema and client
│   └── shared/          # Shared utilities and types
├── tooling/
│   ├── prettier/        # Shared Prettier config
│   ├── typescript/      # Shared TypeScript configs
│   └── vitest/          # Shared Vitest config
├── .oxlintrc.json       # Shared Oxlint rules
├── .env.example         # Environment variables template
├── CLAUDE.md            # AI assistant instructions
├── package.json         # Root workspace configuration
├── pnpm-workspace.yaml  # pnpm workspace definition
└── turbo.json           # Turborepo pipeline config

🛠️ Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Node.js: >=22.14.0 (Download)
pnpm: >=9.6.0 (Installation Guide)
Xcode: 26.4+
Android Studio: Latest version with Android SDK 26+

1. Clone and Install

# Clone the repository
gh repo clone ayush-goyal/universal-template
cd universal-template

# Install dependencies
pnpm install

2. Environment Setup

# Copy environment variables template
cp .env.example .env

# Configure your .env file

3. Firebase Setup

iOS Configuration

Create iOS app in Firebase Console
Download GoogleService-Info.plist
Place at apps/native/config/GoogleService-Info.plist

Android Configuration

Create Android app in Firebase Console
Download google-services.json
Place at apps/native/config/google-services.json

4. Database Setup

# Run migrations
pnpm --filter @acme/db db:migrate

# Open Prisma Studio (optional)
pnpm --filter @acme/db db:studio

5. Billing Setup (Optional)

Stripe is always registered with Better Auth, so configure its secret and webhook keys before starting the web application.

Stripe for web

In Stripe, create one Pro product with monthly and annual recurring prices.
Set the price lookup keys to pro_monthly and pro_annual.
Add STRIPE_SECRET_KEY and STRIPE_WEBHOOK_SECRET to the root .env.
Point the Stripe webhook to https://your-domain.com/api/auth/stripe/webhook.
Enable checkout.session.completed, customer.subscription.created, customer.subscription.updated, and customer.subscription.deleted.
Configure the Stripe Customer Portal and tax registrations. Checkout always enables Stripe Automatic Tax.

Better Auth owns Stripe Checkout, Portal, webhook verification, and the subscription table. The application reads that synchronized table for access; it does not call Stripe on every request.

RevenueCat for iOS and Android

Add iOS and Android apps to one RevenueCat project.
Create an entitlement with lookup key pro.
Attach the App Store and Play Store monthly/annual products to that entitlement and the current offering.
Add the public SDK keys as EXPO_PUBLIC_REVENUECAT_IOS_API_KEY and EXPO_PUBLIC_REVENUECAT_ANDROID_API_KEY.
Create a RevenueCat v2 secret key with customer_information:subscriptions:read, then add REVENUECAT_SECRET_API_KEY and REVENUECAT_PROJECT_ID.
Add a RevenueCat webhook at https://your-domain.com/api/webhooks/revenuecat. Configure an Authorization header and put the exact value in REVENUECAT_WEBHOOK_AUTH.
Keep RevenueCat's default transfer behavior unless your product requires purchases to remain permanently attached to the original application account.

RevenueCat remains native-only. The SDK can create an anonymous customer before sign-in and later link it to a Better Auth user with Purchases.logIn; CustomerInfo is the native entitlement source. For Pro backend authorization, RevenueCat webhooks trigger a current-state API fetch and update only a minimal RevenueCatEntitlement cache. Billing management remains independent: native never reads Stripe billing state, web billing UI never reads RevenueCat, and no provider is called on every application request.

For real purchase testing, use Stripe test mode and a RevenueCat-enabled Expo development build with App Store sandbox and Google Play license-test accounts. Expo Go cannot complete real store purchases.

6. Start Development

# Run all apps in development mode
pnpm dev

# Or run specific apps
pnpm --filter @acme/native dev      # Mobile app
pnpm --filter @acme/web dev         # Web app
pnpm --filter @acme/server dev      # API server

# For Android physical device
pnpm --filter @acme/native adb

7. Cloudflare Deployment

The repository has one workflow, .github/workflows/deploy.yml. Pull requests run checks and build both Workers. A push to main deploys the Hono and vinext Workers.

GitHub only needs Cloudflare deployment credentials:

Repository variable: CLOUDFLARE_ACCOUNT_ID
Actions secret: CLOUDFLARE_API_TOKEN

Configure application secrets directly on the corresponding Worker in Cloudflare. Wrangler preserves existing secrets during deployments. At minimum, set DATABASE_DIRECT_URL on both Workers; the Workerd client uses Prisma Postgres' serverless HTTP/WebSocket adapter rather than a TCP connection. Normal Node development continues to use the pooled DATABASE_URL. Set the Better Auth, Stripe, Resend, Google OAuth, Twilio, OpenAI, RevenueCat, and Sentry values from .env.example on acme-web as the enabled features require them.

pnpm --filter @acme/server exec wrangler secret put DATABASE_DIRECT_URL
pnpm --filter @acme/server exec wrangler secret put ALLOWED_ORIGINS
pnpm --filter @acme/web exec wrangler secret put DATABASE_DIRECT_URL
pnpm --filter @acme/web exec wrangler secret put SITE_URL

Production schema migrations remain an explicit operation:

pnpm --filter @acme/db db:migrate:prod

Wrangler deploys acme-web and acme-server to their workers.dev URLs by default. Add custom domains in Cloudflare and update the web Worker's SITE_URL, OAuth callbacks, Stripe webhooks, and RevenueCat webhooks before production use.

Cloudflare is preconfigured, not mandatory. The default dev, build, and start scripts still use ordinary Next.js and Node, so the web app can deploy to Vercel or another Next.js host and the Hono app can run on any supported Node/container host. Only *:cloudflare scripts select vinext, workerd-specific Prisma output, and Wrangler.

Useful local commands:

# Normal local development stays on Next.js and Node.
pnpm dev

# Cloudflare-only checks and previews are opt-in.
pnpm --filter @acme/web build:cloudflare
pnpm --filter @acme/web preview:cloudflare
pnpm --filter @acme/server build:cloudflare
pnpm --filter @acme/server dev:cloudflare

📜 Essential Commands

Development

# Install dependencies
pnpm install

# Type checking
pnpm typecheck

# Linting
pnpm lint

# Format code
pnpm format

# Clean all build artifacts
pnpm clean

Database

# Run migrations
cd packages/db && pnpm db:migrate

# Deploy migrations (production)
cd packages/db && pnpm db:migrate:prod

🔧 Configuration

Package Naming

All packages use the @acme/ namespace. To rename:

Find and replace @acme/ with @your-company/
Update all package.json files
Update import statements

📚 Additional Resources

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Inspired by create-t3-turbo
Built with tools from the JavaScript ecosystem

Name		Name	Last commit message	Last commit date
.agents		.agents
.claude		.claude
.codex		.codex
.cursor		.cursor
.github/workflows		.github/workflows
.husky		.husky
.vscode		.vscode
apps		apps
packages		packages
tooling		tooling
.env.example		.env.example
.gitignore		.gitignore
.mcp.json		.mcp.json
.npmrc		.npmrc
.nvmrc		.nvmrc
.oxlintrc.json		.oxlintrc.json
.prettierignore		.prettierignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
skills-lock.json		skills-lock.json
turbo.json		turbo.json

Navigation Menu

Repository files navigation

Universal Template

🚀 Features

Core Stack

Authentication & Security

Styling & UI

Data & State Management

Monetization & Analytics

Developer Experience

Mobile-Specific Features

📁 Project Structure

🛠️ Getting Started

Prerequisites

1. Clone and Install

2. Environment Setup

3. Firebase Setup

iOS Configuration

Android Configuration

4. Database Setup

5. Billing Setup (Optional)

Stripe for web

RevenueCat for iOS and Android

6. Start Development

7. Cloudflare Deployment

📜 Essential Commands

Development

Database

🔧 Configuration

Package Naming

📚 Additional Resources

📄 License

🙏 Acknowledgments

About

Releases

Packages

Used by

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Universal Template

🚀 Features

Core Stack

Authentication & Security

Styling & UI

Data & State Management

Monetization & Analytics

Developer Experience

Mobile-Specific Features

📁 Project Structure

🛠️ Getting Started

Prerequisites

1. Clone and Install

2. Environment Setup

3. Firebase Setup

iOS Configuration

Android Configuration

4. Database Setup

5. Billing Setup (Optional)

Stripe for web

RevenueCat for iOS and Android

6. Start Development

7. Cloudflare Deployment

📜 Essential Commands

Development

Database

🔧 Configuration

Package Naming

📚 Additional Resources

📄 License

🙏 Acknowledgments

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages