Configuration

src/config/
├── app.ts             # Core app settings (single Config object)
├── color-variants.ts  # Semantic colors + generic component variants
├── company.ts         # Company info and social links
├── fonts.ts           # Font configuration
└── storage.ts         # Storage bucket definitions

import { Company } from "@/config/company";
import type { MetadataRoute } from "next";

export default function manifest(): MetadataRoute.Manifest {
  return {
    name: Company.Name,
    short_name: Company.Name,
    description: Company.Description,
    start_url: "/",
    icons: [
      /* ... */
    ],
    theme_color: "#ffffff",
    background_color: "#ffffff",
    // ...
  };
}

import Config from "@/config/app";

// Access via: Config.<Area>.<KEY>
Config.Auth.COOKIE_PREFIX;
Config.Theme.DEFAULT;
Config.Navigation.CALLBACK_SEARCH_PARAM;

Config.APP_VERSION; // App version from process env

Config.Pwa.STANDALONE; // Run as standalone app (true) or browser tab (false)

Config.Auth.COOKIE_PREFIX; // Cookie name prefix
Config.Auth.DISABLE_OPENAPI; // Disable OpenAPI docs
Config.Auth.DISABLE_COOKIE_CACHE; // Disable cookie cache for sessions
Config.Auth.STORE_SESSION_IN_DATABASE; // Store sessions in DB
Config.Auth.DISABLE_SESSION_REFRESH; // Disable session refresh
Config.Auth.SESSION_FRESH_AGE; // Freshness check (0 = disabled)
Config.Auth.DISABLE_ACCOUNT_DELETION; // Disable user account deletion
Config.Auth.SIGN_UP_AUTO_LOGIN; // Auto-login after registration

Config.Api.RPC_REQUEST_ID_HEADER; // Header for RPC request IDs
Config.Api.API_KEY_HEADER; // Header for API key auth
Config.Api.DEFAULT_PREFIX; // API key prefix
Config.Api.API_KEY_SKIP_RATE_LIMIT; // Skip rate limits for API key requests
Config.Api.LIST_UNEXPOSED_PROCEDURES_IN_OPENAPI; // Include unexposed procedures in OpenAPI

Config.RateLimit.ENABLED; // Enable/disable rate limiting
Config.RateLimit.LOG_VIOLATIONS; // Log rate limit violations
Config.RateLimit.SEND_METRICS; // Send rate limit metrics

Config.Theme.DEFAULT; // "light" | "dark" | "system"
Config.Theme.ENABLE_SYSTEM; // Allow system theme detection
Config.Theme.FORCE; // Force specific theme (overrides user)

Config.Ui.TABLE_ROW_OPTIONS; // Pagination options [20, 50, 100]
Config.Ui.DEFAULT_TOAST_DURATION; // Toast duration in ms
Config.Ui.AUTH_LAYOUT; // "image-form" | "centered-blank" | "card-over-image"
Config.Ui.NAVIGATION_LAYOUT; // "sidebar" | "floating"

Config.CookieBanner.POSITION; // "center" | "bottom-left" | "bottom-right" | "full" | "top-bar"
Config.CookieBanner.ANIMATION_ENABLED; // Enable slide/fade animation

Config.Date.MIN_CALENDAR_DATE; // Earliest calendar date
Config.Date.MAX_CALENDAR_DATE; // Latest calendar date

Config.Navigation.CALLBACK_SEARCH_PARAM; // Redirect callback param
Config.Navigation.LOCALE_COOKIE_KEY; // Locale cookie name
Config.Navigation.LOCALE_HEADER_KEY; // Locale header key
Config.Navigation.TIMEZOME_HEADER_KEY; // Timezone header key
Config.Navigation.PATHNAME_HEADER; // Pathname header key
Config.Navigation.DEFAULT_TIMEZONE; // Default timezone

Config.Storage.STORAGE_PROVIDER; // Storage provider type (see src/config/storage.ts)
Config.Storage.FILENAME_DIVIDER; // Divider for unique filenames
Config.Storage.PRIVATE_FILE_URL_EXPIRATION_HOURS; // Signed URL expiry

Config.Analytics.SESSION_ID_COOKIE_NAME; // Session cookie name
Config.Analytics.SESSION_ID_UPDATE_COOKIE_NAME; // Session refresh cookie name

Config.Billing.DEFAULT_CURRENCY; // Default currency code
Config.Billing.DEFAULT_CURRENCY_FORMAT_LOCALE; // Locale for currency formatting
Config.Billing.ORGANIZATION_BILLING; // Enable organization billing
Config.Billing.USER_BILLING; // Enable user billing
Config.Billing.ENABLED; // Computed billing enabled state

Config.Users.USERNAME_SUFFIX_NUMBERS; // Random username suffix digits

import { Company } from "@/config/company";

Company.Name; // Company name
Company.SupportEmail; // Support email
Company.Socials; // Social media handles

import { getSocialUrl, type SocialsType } from "@/lib/links";

const url = getSocialUrl("instagram", "mycompany");
// Returns: "https://instagram.com/mycompany"

// ✅ Good
import Config from "@/config/app";

if (Config.Auth.SIGN_UP_AUTO_LOGIN) {
  // Auto-login logic
}

// ❌ Bad - hardcoded value
if (false) {
  // Auto-login logic
}