Documentation

Documentation

CodeBaseHub - React Native + Next.js monorepo starter with shared packages

CodeBaseHub

Monorepo starter for building web and mobile apps with shared packages.

Stack

Apps:

  • Next.js 15 (web)
  • React Native + Expo (mobile)

Shared Packages:

  • @repo/auth-utils - Better-auth setup
  • @repo/config - Unified configuration
  • @repo/i18n - Internationalization
  • @repo/onesignal - Push notifications
  • @repo/tailwind-config - Shared styling

Key Dependencies:

  • Better-auth for authentication
  • tRPC for API layer
  • TanStack Query for data fetching
  • NativeWind for mobile styling
  • RevenueCat for mobile payments
  • AppsFlyer for mobile analytics
  • Expo Router for navigation

Quick Start

# Clone and install
git clone <repo-url>
pnpm install

# Start development
pnpm dev        # Both apps
pnpm dev:web    # Web only (port 3001)
pnpm dev:native # Mobile only

Project Structure

apps/
├── web/           # Next.js app
└── native/        # React Native app

packages/
├── auth-utils/    # Better-auth configuration
├── config/        # Shared config
├── i18n/          # Internationalization
├── onesignal/     # Push notifications
└── tailwind-config/  # Styling

Features

  • Shared authentication across platforms
  • Unified configuration system
  • Multi-language support (en, tr, ar)
  • Push notifications (OneSignal)
  • Mobile payments (RevenueCat)
  • Analytics (AppsFlyer)
  • Type-safe APIs (tRPC)