OneApp Documentation

Welcome to the OneApp documentation! This is your guide to building scalable Next.js applications with our production-ready monorepo.

Quick Links

What is OneApp?

OneApp is a production-ready pnpm monorepo for building scalable Next.js 16 applications with:

• Shared packages (@repo/*) for UI components, utilities, authentication, AI, and more
• Team workspaces for isolated development
• Modern tooling with TypeScript 5 (strict mode), ESLint 9, Vitest 4, and Tailwind CSS 4
• 40+ packages battle-tested across production applications

Key Technologies

Getting Started

# Clone the repository
git clone https://github.com/OneDigital-Product/monorepo.git
cd monorepo

# Install dependencies
pnpm install

# Start development
pnpm dev

Your app is now running at http://localhost:3000.

Documentation Sections

Getting Started

Everything you need to set up and start developing:

• Prerequisites and environment setup
• Installation guide
• Project structure overview
• Essential commands

Core Concepts

Understand the fundamental architecture:

• Workspace architecture with pnpm
• Dependency management
• Type safety patterns with branded types

Packages

Explore all 35+ shared packages:

• AI - Vercel AI SDK wrapper with streaming and tools
• Auth - Better Auth integration for web and mobile
• Database - Prisma, Redis, and Vector DB
• UI - React components with Tailwind CSS

Guides

Best practices and tutorials:

• Coding conventions
• Git workflow
• Error handling patterns
• Creating new packages

Platform Apps

Learn about the infrastructure applications:

• OneApp Onstage (consumer app)
• OneApp Backstage (AI designer)
• OneApp API (REST server)
• Storybook and mobile app