Documentation
Documentation
Introduction

Getting Started

Getting started
Getting StartedInstallationQuick StartProject Structure

Configuration

Configuration
ConfigurationEnvironment ConfigurationEdge ConfigDatabaseAuth SecretStripeFirebaseStorageGoogle Maps And Cloud Service AccountOAuth ProvidersEmail DeliverySentryFeature Flags

Architecture

Architecture
Architecture OverviewTech StackoRPC MiddlewareDesign Principles

Patterns

Patterns
Code Patterns & ConventionsFeature ModulesError HandlingType Safety

Database

Database
DatabaseSetupSchema DefinitionDatabase OperationsMigrationsCaching
Data Tables

API

oRPCProceduresRoutersoRPC Proxy Setup
APIsOpenAPIREST Endpoints

Auth & Access

AuthenticationConfigurationOAuth ProvidersRolesSession Management
AuthorizationUser RolesPermissions

Routing & i18n

RoutingDeclarative RoutingNavigation
InternationalizationTranslationsLocale Routing

Components & UI

ComponentsButtonsFormsNavigationDialogs
StylesTailwind CSSThemingTypography

Storage

Storage
StorageConfigurationUsageBuckets
Stripe Billing

Extra

Caching

Templates

Templates
Template GuidesCreate New FeatureCreate New PageCreate Database TableCreate oRPC RouterAdd Translations

Development

Development
DevelopmentCommandsAI AgentsBest Practices
Pulling Updates

OAuth Providers

Configure Google and GitHub OAuth credentials

Variables

VariableRequiredPurpose
GOOGLE_CLIENT_IDYes (for Google OAuth)Google OAuth client identifier.
GOOGLE_CLIENT_SECRETYes (for Google OAuth)Google OAuth client secret.
GITHUB_CLIENT_IDYes (for GitHub OAuth)GitHub OAuth app client ID.
GITHUB_CLIENT_SECRETYes (for GitHub OAuth)GitHub OAuth app secret.

Google OAuth

  1. Open Google Cloud Console.
  2. Open APIs & Services -> OAuth consent screen and complete required fields.
  3. Go to APIs & Services -> Credentials.
  4. Click Create credentials -> OAuth client ID.
  5. Select application type Web application.
  6. Add authorized redirect URLs:
    • http://localhost:3000/api/auth/callback/google
    • https://<your-domain>/api/auth/callback/google
  7. Click create and copy client ID/secret to env.
GOOGLE_CLIENT_ID="...apps.googleusercontent.com"
GOOGLE_CLIENT_SECRET="..."

GitHub OAuth

  1. Open https://github.com/settings/developers.
  2. Click OAuth Apps -> New OAuth App.
  3. Fill app name and homepage URL.
  4. Set callback URLs:
    • http://localhost:3000/api/auth/callback/github
    • https://<your-domain>/api/auth/callback/github
  5. Click create app.
  6. Copy client ID and generate client secret.
GITHUB_CLIENT_ID="..."
GITHUB_CLIENT_SECRET="..."

Security Notes

  1. Do not expose client secrets to browser code.
  2. Use separate OAuth apps for dev and production when possible.
  3. Keep callback URLs exact (protocol + domain + path).

On this page

Variables
Google OAuth
GitHub OAuth
Security Notes