Pages and sections — Kalme Next.js

A page is a small file that picks sections and hands them content. src/app/services/page.tsx is the whole Services page:

export const metadata: Metadata = pageMeta(routes.services, servicesPage.meta);

export default async function ServicesPage() {
  const services = await getServices();
  return <ServicesListSection {...servicesPage} services={services.map(toServiceRow)} />;
}

• pageMeta(route, meta) gives the page its browser title, description, canonical link and share image.
• getServices() reads the collection (see Editing the content); toServiceRow turns each service into what the row component shows (src/lib/to-ui.ts).
• The section renders them.

The sections you can use

In src/components/sections/. Each takes its copy from a page file and its items from a collection.

Section	Used on
HomeHeroSection, PageVideoSection, HomeAboutSection, HomeServicesSection, HomeProjectsSection, TestimonialsSection, HomeBlogSection, CtaSection	Home
AboutHeroSection, ValuesSection, PageVideoSection, TeamSection	About
ServicesListSection	Services
ServiceHeroSection (with ServiceContentSection inside it), MoreServicesSection	Service
ProjectsListSection	Projects
ProjectHeroSection, ProjectStorySection (three times: overview, process, result), RelatedProjectsSection, CtaSection	Project
BlogListSection	Blog
PostMainSection, MorePostsSection	Blog post
ContactSection	Contact
LegalSection	Terms of Service, Privacy Policy
NotFoundSection	404

PageVideoSection and CtaSection appear on two pages each: the video comes from the page file (video in home.ts and about.ts), the call to action from cta in src/content/site.ts, so changing it once changes it everywhere.

Page maps

Every page type with each section outlined and labelled: the component that renders it, the file to edit, and where its copy (src/content/pages/*.ts) and items (src/content/collections/*.ts) come from. Header and footer take their links and details from src/content/site.ts. Photos are the placeholders of the download.

Home

About

Services

Service

The service’s title, description and first image open the page; “What We Offer”, “Key Benefits”, “Tools” and the pricing card come from the same service in services.ts, their headings from src/content/pages/service.ts.

Projects

Project

Blog

Blog post

Contact

Legal

Page not found

Reordering or removing a section

Move the lines in the page file, or delete one. To take the testimonials off the home page, delete <TestimonialsSection … /> from src/app/page.tsx; its copy in src/content/pages/home.ts can stay or go.

Adding a page

1. Add the URL to src/content/routes.ts:

   pricing: "/pricing",

2. Add its copy to src/content/pages/pricing.ts, with a meta (title, description):

   export const pricingPage = {
     meta: { title: "Pricing", description: "What our services cost, from a single campaign to a monthly retainer." },
   };

3. Create src/app/pricing/page.tsx:

   import type { Metadata } from "next";
   import { CtaSection } from "@/components/sections/CtaSection";
   import { pricingPage } from "@/content/pages/pricing";
   import { routes } from "@/content/routes";
   import { cta } from "@/content/site";
   import { pageMeta } from "@/lib/meta";
   
   export const metadata: Metadata = pageMeta(routes.pricing, pricingPage.meta);
   
   export default function PricingPage() {
     return <CtaSection {...cta} />;
   }

4. Link to it: add { label: "Pricing", href: routes.pricing } to navigation in src/content/site.ts, or to the footer’s quickLinks.
5. Add it to src/app/sitemap.ts, next to the other top-level pages.

Removing a page

Delete its folder under src/app/, its entry in navigation, in the footer’s links and in src/app/sitemap.ts, and the route in routes.ts. npm run build then tells you about anything still linking to it through routes.

Pages built from a collection

src/app/blog/[slug]/page.tsx builds one page per post:

export const dynamicParams = false;                     // only the slugs below exist; anything else is a 404
export async function generateStaticParams() {
  return (await getPosts()).map((post) => ({ slug: post.slug }));
}

Add a post to src/content/collections/posts.ts and its page, its links and its sitemap entry appear on the next build. The same pattern builds the service, project and legal pages.

The 404 page

src/app/not-found.tsx, with its copy in src/content/pages/not-found.ts. It is noindex, like the style guide.

Search engines

• src/app/sitemap.ts builds sitemap.xml from routes.ts and the collections, so new items list themselves. The 404 page and the style guide are left out.
• src/app/robots.ts builds robots.txt and points at the sitemap. Both use site.url, so set your domain before publishing.
• Every indexable page gets a title, a description, a canonical link, an og:url and a share image from pageMeta (src/lib/meta.ts). A title that would be longer than 60 characters with | Kalme appended is shown without the suffix.
• noindex pages: the style guide and the 404 page.