Runway
HomeComponentsPricingDev Tools

Start Here

  • Overview
  • Installation
  • Project Structure

Customize

  • Customization
  • Runtime Configuration
  • Site Content

Build

  • Components
  • Layout
  • Brand

Product Systems

  • Auth, Billing, Email, SEO, Security
Loading docs page
Built withRunway
  1. Customize
  2. Runtime Configuration

Runtime Configuration

What belongs in runtime config and how feature toggles are wired.

What belongs here

src/config/runtime.js is the place for serializable runtime decisions such as:

  • App metadata and environment-aware URLs
  • Provider flags and operational toggles
  • Legal and policy route settings
  • Auth, billing, analytics, and email configuration

Keep it data-only so it stays safe to read in routing, metadata, and server code.

Safe editing rules

  1. Prefer booleans, strings, numbers, arrays, and plain objects.
  2. Keep secrets in environment variables, not in committed config.
  3. Add only the smallest setting needed for the feature you are enabling.
  4. If behavior lives in a component or route, keep the behavior there and only reference config from it.
Do not turn config into application logic

src/config/runtime.js should not become a registry of React nodes, route handlers, or compatibility wrappers. Keep it declarative.

When to use other files

If you are changing homepage copy or section structure, update src/config/landing-page.js, src/config/foundation.js, or src/docs/content/*.

If you are changing navigation, update src/config/navigation.js or src/config/docs-nav.js.

If you are changing how something renders, edit the relevant shared component instead of pushing UI concerns into runtime config.

Related

  • Customization
  • Auth, Billing, Email, SEO, Security
  • Project Structure

On This Page

  • What belongs here
  • Safe editing rules
  • When to use other files

Related

  • Customization
  • Auth, Billing, Email, SEO, Security
  • Project Structure