Site, Navigation & Metadata

Site-wide settings live in src/config. These plain TypeScript modules drive branding, navigation, social links, and routes, while page metadata (title, description, metadataBase) is set in the root locale layout.

Important files

Branding & contact: website-config.ts

This is the first file to edit when you rebrand. It holds social profile URLs and the addresses used for outgoing and inbound mail:

export const websiteConfig: WebsiteConfig = {
  metadata: {
    social: {
      github: "https://github.com/your-username",
      twitter: "https://twitter.com/your-username",
      // linkedin, facebook, instagram, tiktok, telegram…
    },
  },
  mail: {
    provider: "resend",
    fromEmail: "SoarStarter <noreply@mail.soarstarter.com>",
    supportEmail: "contact@soarstarter.com",
  },
};

social-config.ts reads these values and returns only the links that are set, so removing a handle removes its icon. fromEmail/supportEmail feed the email flows.

Navigation

• Footer — footer-config.ts exports getFooterLinks(t), grouping links into Product / Resources / Company / Legal columns. It takes a next-intl translator t, so column and link labels come from messages/*.json; the hrefs come from the Routes enum.
• Routes — route-config.ts centralises every internal path as a Routes enum (Routes.Pricing, Routes.AuthLogin, Routes.Dashboard, …). Reference the enum instead of hardcoding strings so paths stay consistent.
• Dashboard sidebar — user-sidebar-config.ts exports getSidebarLinks() with role-aware items (roles: ["admin"]). When NEXT_PUBLIC_IS_DEMO is true, admin links are shown to everyone for the demo.

Metadata

Page metadata is defined in the locale root layout, not in a config file:

export const metadata: Metadata = {
  metadataBase: new URL(
    process.env.NEXT_PUBLIC_SITE_URL ?? "https://soarstarter.com",
  ),
  title: "SoarStarter Next",
  description:
    "SoarStarter is a production-oriented SaaS template built with Next.js…",
};

metadataBase resolves relative Open Graph / canonical URLs, so set NEXT_PUBLIC_SITE_URL in production. Individual pages can export their own metadata or generateMetadata to override the title and description.

Rebrand checklist

Related pages