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

Auth Secret

Generate and configure BETTER_AUTH_SECRET safely

Variable

VariableRequiredPurpose
BETTER_AUTH_SECRETYesSigning/encryption secret for auth sessions and tokens.

Recommended Generation Methods

OpenSSL (CLI)

Generate a long random secret:

openssl rand -base64 48

Alternative:

openssl rand -hex 32

Web Generator

Use https://randomkeygen.com/random-string if CLI is not available.

Requirements and Tips

  1. Minimum: 32+ characters.
  2. Recommended: 64+ random characters.
  3. Use different values for each environment.
  4. Never commit secrets to git.

Example

BETTER_AUTH_SECRET="a-very-long-random-secret-value"

On this page

Variable
Recommended Generation Methods
OpenSSL (CLI)
Web Generator
Requirements and Tips
Example