Docs LATEST

App Configuration

Core app options.

Configuration

config/app.php contains core application metadata and environment toggles.


Keys #

Key Env Variable Description
app.name APP_NAME Display name (default: VelvetCMS)
app.url APP_URL Base URL without trailing slash
app.env APP_ENV Environment label (production vs anything else)
app.debug APP_DEBUG Enables detailed error rendering
app.timezone - Default timezone (default: UTC)
app.locale - Default locale (default: en)

Optional keys #

These are read by the core but are not present in the default file:

  • app.cron_enabled - enables the WebCron endpoint at /system/cron.

Overrides go in user/config/app.php.


Environment and debug #

app.debug defaults to true unless APP_ENV=production. In production, keep debug off and use ./velvet optimize to validate environment settings.

Example:

// user/config/app.php
return [
    'name' => 'My Site',
    'timezone' => 'Europe/Warsaw',
];