v1.6.x-dev NDS IQ v6

Foundation Day Theme - National Design System

A ready-made event theme for Saudi Founding Day. One script tag re-skins the site with the heritage brown palette and adds a bilingual hero slide. Delete the tag to restore the default.

Preview it live

Pick Foundation Day from the theme switcher in the top bar: the site re-skins and the event slide appears. Switch back to undo.

Automatic

Add one tag to your shared <head>, after the NDS stylesheets and without defer. It applies the palette and the hero slide; remove it when the event ends. Every data-* below is optional (defaults shown); see the table for each one.

The pack is self-contained: copy docs-assets/events/foundation_day/ out of the template into your own assets folder, then point the tag at wherever you put it. The paths below assume assets/events/foundation_day/. The script finds its own CSS and images relative to itself, so the folder works at any location as long as its contents stay together.

One tag applies everything
<script src="/assets/events/foundation_day/nds-theme-foundation-day.min.js" data-title-ar="يوم بدينا" data-title-en="Our Story" data-description-ar="تأسيس نعتز به، ومستقبل نصنعه" data-description-en="A founding we cherish, a future we shape" data-image="https://cdn.example.sa/img/founding-hero-2026.webp" data-cta-url="https://www.foundingday.sa/" data-cta-label-ar="منصة يوم التأسيس" data-cta-label-en="Foundation Day Platform" data-cta-icon="founding-icon.svg"></script>

Manual (no JavaScript)

No-JS alternative: link the stylesheet for the palette, and paste the slide markup yourself. Add the CSS link in <head>, and place the slide as the first child of .nds-swiper-wrapper (raise the hero's --total by one).

No-JS setup: stylesheet link and slide markup
<link id="nds-theme-stylesheet" rel="stylesheet" href="/assets/events/foundation_day/nds-theme-foundation-day.min.css">

Data Attributes

All go on the <script> tag, all optional. Asset values take a bare filename (resolved against the pack folder) or a full https URL.

AttributeDefaultDescription
data-title-ar / data-title-enيوم بدينا / Our StorySlide heading per language.
data-description-ar / data-description-enتأسيس نعتز به، ومستقبل نصنعه / A founding we cherish, a future we shapeSlide description. Empty value hides it.
data-imageHero_bg.webpBackground photo. Empty value uses the brown background variant.
data-cta-urlhttps://www.foundingday.sa/Button link. Empty removes the button; non-https is rejected.
data-cta-label-ar / data-cta-label-enمنصة يوم التأسيس / Foundation Day PlatformButton label per language.
data-cta-iconfounding-icon.svgButton icon. Empty omits it.

Built-in Features

One-Tag Activation

One script tag applies the palette, root marker, and hero slide. No build, no markup edits.

Zero-Flash First Paint

Placed in the head, the stylesheet resolves before first paint, so the default colours never flash.

Configurable Hero Slide

Set the slide title, description, photo, and CTA with data-* attributes; defaults when omitted.

Bilingual Content

Each string has Arabic and English values; the pack picks one from the page lang.

Clean Removal

Delete the tag and the palette, token, and slide are gone on the next load.

Theme Switcher Integration

The same pack plugs into the theme switcher: loads on demand, applies on selection, tears down on switch-away.

Usage Guidelines

Best Practices

  • Use an event pack for a temporary, site-wide skin tied to an occasion. For a permanent brand colour, use a custom palette or stylesheet theme instead.
  • Add the tag to your shared <head> on every page, not just the home page, so the palette stays consistent.
  • Override data-cta-url to your own landing page so analytics stay on your domain.
  • Host the pack folder yourself instead of hotlinking a third-party origin.
  • Plan the removal up front: deleting the one line is the entire decommissioning.
Was this page useful?
60% of users said Yes from 2843 Feedbacks