Skip to content

About

Showcase of my integration / full-stack work on The Grid — Next.js 16 + Payload 3, 7 locales, CMS-driven theming & SEO

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

The Grid — Showcase

Public showcase of my integration & full-stack work on The Grid, a multilingual motorsport-agency website. The production code lives in a private repository — this repo presents the architecture, the front-end craft, the headless CMS, and the SEO system, with a handful of representative (non-sensitive) code excerpts.

Built by Simon Azoulay — GraciaMedia. Design integration, front-end engineering, headless CMS architecture, i18n & SEO.


What it is

A fully localized agency site (driver roster, news/case-studies, services, contact) built on a modern React Server Components stack with a headless CMS that lets a non-technical team run the site — content, translations, and even the visual theme — entirely from an admin back office.

Framework Next.js 16 (App Router, React Server Components)
Language TypeScript (strict)
CMS Payload 3 (headless, Lexical editor, French-labeled admin)
Database Postgres (Neon) in prod · SQLite locally
Styling Tailwind CSS v4 + CMS-driven design tokens
Motion Framer Motion (scroll parallax, staggered reveals, reduced-motion aware)
i18n next-intl — 7 locales (en, fr, es, de, it, nl, zh)
Media / Email / AI Vercel Blob · Resend · OpenAI (translation + vision)
Hosting Vercel (ISR, on-demand revalidation)

Front-end / integration highlights

The front end is component-driven (~55 components organized by feature, not by type) and entirely server-rendered with selective client interactivity.

  • Pixel-faithful integration of the agency design across home, about, services, drivers list + driver detail, news list + article, and contact.
  • Shared motion language — a single Framer Motion variant library (snippets/motion.tsx) keeps timing, easing and stagger consistent everywhere; prefers-reduced-motion is honored globally via <MotionConfig reducedMotion="user">.
  • Scroll-driven effects — hero parallax (useScroll + useTransform), an F1-inspired headlight-beam sweep on the About section, staggered card reveals, glassmorphism sticky header on scroll.
  • Fluid responsive layout — clamp() typography/spacing, container-aware breakpoints, scroll-snap carousels, mobile-specific overlays. Mobile-first.
  • Image pipeline — next/image with AVIF/WebP, art-directed sizes, CMS focal points (object-position), CDN + Vercel Blob sourcing, immutable long-TTL caching.
  • Typography — next/font (Poppins, League Spartan, Inter, Syne) with swap + preloading strategy per font.

Live, CMS-driven theming

A standout integration piece: the visual theme is data. A Payload global exposes typed design knobs (accent color, card radius, hover style, section spacing, hero scale, global font, header style…) that resolve server-side into CSS custom properties injected in <head>. The team re-themes the entire site from the admin — no deploy.

→ snippets/design-settings.ts


Back-office / Payload CMS highlights

The site is fully editable by a non-technical team through a French-labeled Payload admin, structured into 8 collections and 7 globals.

Collections — News (block-based articles), Drivers (profiles, careers, galleries), Team Members, News Tags (URL-stable filters), Media, Newsletter Subscribers, Contact Submissions, Users.

Globals — Homepage, About, Services, Drivers, Contact pages, Site Settings, and Design Settings — each with configurable section ordering and per-page SEO.

Key engineering:

  • Non-destructive AI translation. English is canonical. On save, an endpoint walks the Payload schema, extracts every localized text field (nested groups, tabs, arrays, blocks), and translates via OpenAI — preserving placeholders, inline HTML, brand names and slugs. A lockedLocales mechanism means a human edit to any locale is never overwritten by the machine.
  • AI media descriptions. Uploaded images are auto-described via OpenAI Vision (alt/subject/tags), run in the background so uploads stay fast.
  • Reusable field factories — a localized seoField() and an image/focal-point field drop into any collection or global (snippets/seo-field.ts).
  • Hooks for cache correctness — afterChange/afterDelete trigger targeted, locale-aware ISR revalidation, so a save in the admin reflects on production in seconds without a rebuild.
  • Custom admin components — media-library image picker, design-settings UI, per-locale translation-status indicators, bulk CSV export for leads.
  • Server-side access control — public read, authenticated writes; public create only on form-submission collections.

SEO system

SEO is treated as a first-class subsystem, fully driven by the typed locale table.

  • hreflang + canonical — correct alternates for all 7 locales, x-default, trailing-slash–normalized canonicals. Hreflang is only emitted for locales that actually have a translation.
  • Per-locale OpenGraph (en_US, fr_FR, …) and Twitter cards.
  • JSON-LD structured data — Organization + WebSite site-wide; NewsArticle and Person schemas on detail pages, emitted safely per Next.js 16 guidance (snippets/json-ld.ts).
  • Editable meta — every page/collection carries a localized seoField so editors control <title>/description/OG image, with translated defaults as fallback.
  • Database-backed sitemaps — a sitemap index plus one sitemap per locale, generated from live CMS content, cached and revalidated.
  • robots.txt that explicitly welcomes AI crawlers (GPTBot, ClaudeBot, PerplexityBot…) while protecting /admin and /api.
  • Trailing-slash invariant enforced once in middleware (308) and matched across links, canonicals and sitemaps — no redirect loops, no duplicate URLs.

Reliability & DX

  • Schema self-heal — an idempotent pre-build step creates any missing relationship tables/indexes, hardening serverless cold-start builds.
  • Retry wrapper around CMS reads to tolerate database cold starts.
  • Security headers — HSTS, CSP, X-Content-Type-Options, referrer & permissions policies, COOP/CORP.
  • CI mirrors the deploy — type-check + lint + build run in GitHub Actions before every deploy.

Code excerpts

Representative, non-sensitive excerpts (trimmed and lightly adapted to stand alone):

File What it shows
snippets/motion.tsx Shared Framer Motion variant library
snippets/i18n-config.ts 7-locale source of truth feeding routing + SEO
snippets/design-settings.ts CMS-driven design tokens → CSS variables
snippets/seo-field.ts Reusable localized SEO field factory (Payload)
snippets/json-ld.ts Safe JSON-LD structured-data helpers

No credentials, environment values, client data, or proprietary content are included in this repository. Code excerpts are illustrative and provided for portfolio purposes.

About

Showcase of my integration / full-stack work on The Grid — Next.js 16 + Payload 3, 7 locales, CMS-driven theming & SEO

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages