Configuration

Launch Now keeps product identity, legal details and secrets in three places: siteConfig for the product itself, legalConfig for the legal documents, and environment variables validated by lib/env.ts. This page lists every field, its type and default, and the code that reads it.

siteConfig

siteConfig is the single source of truth for the product identity. The demo values describe Pulse, a placeholder product: replace them with your own.

export const siteConfig = {
  name: "Pulse",
  slug: "pulse",
  tagline: "Product analytics for teams that ship every week.",
  description:
    "Pulse turns every click, signup and upgrade into answers your whole team can act on.",
  url: process.env.NEXT_PUBLIC_APP_URL ?? "http://localhost:3000",
  ogImage: "/opengraph-image",
  links: {
    twitter: "https://x.com/antonio_rnv",
    github: "https://github.com/anthonyRanivoarison/app.launch.now",
  },
  supportEmail: process.env.NEXT_PUBLIC_SUPPORT_EMAIL,
  creator: "@antonio_rnv",
  locale: "en_US",
  themeColor: "#09090b",
  geo: {
    region: "FR",
    placename: "Paris, France",
    latitude: "48.8566",
    longitude: "2.3522",
  },
}

name

• Type: string
• Default: "Pulse"

Display name. Read by the root metadata and title template (app/layout.tsx), app/manifest.ts, app/opengraph-image.tsx, the JSON-LD (lib/seo/json-ld.ts), createSeoHead (lib/seo/metadata.ts), the docs nav title (lib/layout.shared.ts), Better Auth's appName and the OTP email (lib/auth.ts), newsletter emails (lib/newsletter-actions.ts, features/newsletter/newsletter-composer.tsx), the password-set email (lib/account-actions.ts), legalConfig.product.name, scripts/seed-plans.ts, and user-facing copy in the auth pages, marketing sections, onboarding, changelog, status, error pages and the profile form.

slug

• Type: string
• Default: "pulse"

Machine name. Used as:

• the API key prefix (<slug>_, set as defaultPrefix of the apiKey plugin in lib/auth.ts), also shown as a fallback in features/account/api-keys/api-key-row.tsx;
• the Stripe price lookup keys (<slug>-pro-monthly, <slug>-ultra-monthly) and the app metadata tag on Stripe products in scripts/stripe-create-products.ts and scripts/stripe-update-features.ts.

tagline

• Type: string

Short pitch. Read by the home page title (app/page.tsx), the Open Graph image and its alt (app/opengraph-image.tsx) and features/marketing/brand.tsx.

description

• Type: string

Default meta description. Read by app/layout.tsx, app/page.tsx, app/manifest.ts, app/opengraph-image.tsx, lib/seo/json-ld.ts, and createSeoHead when a page passes no description.

url

• Type: string
• Default: process.env.NEXT_PUBLIC_APP_URL, or "http://localhost:3000" when unset.

Public base URL. Used as metadataBase and to build absolute URLs in app/layout.tsx, lib/seo/metadata.ts, lib/seo/json-ld.ts, app/sitemap.ts, app/robots.ts, app/changelog/rss.xml/route.ts, and as legalConfig.product.url.

ogImage

• Type: string
• Default: "/opengraph-image"

Path of the generated Open Graph image. No code currently reads this field; Next.js serves app/opengraph-image.tsx by file convention.

links

• Type: { twitter: string; github: string }

Social profiles. Rendered in the marketing footer (features/marketing/footer.tsx) and added to the Organization JSON-LD sameAs list (empty values are skipped).

supportEmail

• Type: string | undefined
• Default: process.env.NEXT_PUBLIC_SUPPORT_EMAIL

When set, the app sidebar shows a Support mailto: link (components/layouts/nav-configs/dashboard.tsx). When unset, the link is hidden.

creator

• Type: string
• Default: "@antonio_rnv"

Twitter / X handle used for twitter.creator in app/layout.tsx and createSeoHead.

locale

• Type: string
• Default: "en_US"

Open Graph locale in app/layout.tsx and the default locale of createSeoHead.

themeColor

• Type: string
• Default: "#09090b"

Browser theme color (viewport.themeColor in app/layout.tsx) and the manifest's background_color and theme_color.

geo

• Type: { region: string; placename: string; latitude: string; longitude: string }

Emitted by createSeoHead as geo.region, geo.placename, geo.position (latitude;longitude) and ICBM meta tags.

legalConfig

legalConfig holds everything the legal documents under /legal need. Any string that still starts with TODO is reported by pnpm legal:check (which exits with code 1) and shown in a warning banner on /legal pages in development. See Legal pages for the workflow.

effectiveDate

• Type: string (ISO date, YYYY-MM-DD)

Date the current version takes effect. Formatted by formatEffectiveDate() in features/legal/types.ts and shown as the "last updated" date on /legal and each document.

product

company

The Legal Notice lists all company fields and skips empty ones. companyName() is used by the Terms, Privacy Policy and DPA; address and country also appear in Terms and Privacy.

contact

publicationDirector

• Type: string
• Default: TODO

Person responsible for the content ("Directeur de la publication", required in France). Shown in the Legal Notice.

host

Listed in the Hosting section of the Legal Notice.

jurisdiction

audience

billing

retention

subprocessors

• Type: Subprocessor[]

export type Subprocessor = {
  name: string
  purpose: string
  /** Where the data is processed, e.g. "United States", "EU (Frankfurt)". */
  location: string
  url: string
}

Listed in the Privacy Policy and the DPA. The default list covers Neon (database and object storage), Stripe, Resend, GitHub and Google. The Neon database location is a TODO.

cookies

• Type: CookieEntry[]

export type CookieCategory =
  "essential" | "preferences" | "analytics" | "marketing"
 
export type CookieEntry = {
  name: string
  provider: string
  purpose: string
  duration: string
  category: CookieCategory
}

Read by the Cookie Policy (which adds tracker wording when any cookie is analytics or marketing) and by the cookie consent dialog (features/cookie-consent/cookie-consent.tsx), which groups cookies by category and clears first-party cookies of a category the user declines. Defaults: better-auth.session_token, better-auth.last_used_login_method, better-auth.two_factor, cookie_consent, open_app (all essential) and sidebar_state (preferences).

Add an entry here whenever you add a cookie or a third-party script.

findLegalPlaceholders()

function findLegalPlaceholders(value?: unknown, path?: string): string[]

Walks legalConfig and returns the dotted paths (for example company.address or subprocessors[0].location) of every string starting with TODO. Used by scripts/legal-check.ts and the /legal pages.

Environment variables

lib/env.ts validates environment variables with @t3-oss/env-nextjs and Zod. Import env from @/lib/env in server code instead of reading process.env:

import { env } from "@/lib/env"
 
const from = env.EMAIL_FROM

Set SKIP_ENV_VALIDATION to any non-empty value to skip validation (for example in CI builds). Copy .env.example to .env to start.

Server variables

Client variables

Not validated

Add a variable

export const env = createEnv({
  server: {
    // ...
    MY_API_KEY: z.string().min(1),
  },
  runtimeEnv: {
    // ...
    MY_API_KEY: process.env.MY_API_KEY,
  },
})

Related