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

Sentry

Configure Sentry org/project identifiers, DSN, and auth token

Variables

VariableRequiredPurpose
SENTRY_AUTH_TOKENYesAuth token for sourcemaps/build integrations.
SENTRY_ORGYesSentry organization slug.
SENTRY_PROJECTYesSentry project slug.
NEXT_PUBLIC_SENTRY_DSNYesPublic DSN for SDK initialization.

Setup Steps

  1. Open Sentry.
  2. From top-left user menu, open Projects.
  3. Click Create Project.
  4. Select Next.js, choose project slug, then create.
  5. Copy DSN and set NEXT_PUBLIC_SENTRY_DSN.
  6. Organization slug is the text before .sentry.io in your Sentry URL. Set this in SENTRY_ORG.
  7. Project slug is the project identifier in Sentry project settings. Set this in SENTRY_PROJECT.
  8. Open Developer Settings -> Personal Tokens.
  9. Click Create Token and grant permissions:
    • event:read
    • org:read
    • project:read
  10. Copy token and save to SENTRY_AUTH_TOKEN.

Example

SENTRY_ORG="your-org"
SENTRY_PROJECT="your-project"
NEXT_PUBLIC_SENTRY_DSN="https://...@o123456.ingest.sentry.io/123456"
SENTRY_AUTH_TOKEN="sntrys_..."

Token Scope

Keep token scope minimal and rotate periodically.

On this page

Variables
Setup Steps
Example