# Recreate the SDS showcase

The main website consumes the same public SDS code supplied to people and AI. Use the expressive starter for the complete page, or independent scenes for a smaller project. Preserve real content, navigation and a complete static page.

## Entry points

For ordinary sites, load `sylhet/sds.css` and the module `sylhet/sds.js`. For the expressive page, start with `recipes/expressive/index.html`, load `sylhet/vendor/expressive/layout.css` and `sylhet/css/scenes.css`, then load `sylhet/sds.js`. Keep `data-sds-expressive` on the root. Do not load two full CSS bases together.

The preset retains the supplied Leneroo layout, nav morph, hero cycle, traveling mark, photographic transition, connected cards, image stack, chapters, FAQ, outro and WebGL ending. New square actions, orbit carriers, gravity words, opening and motion panels are readable SDS modules. The original button DOM remains; `data-sds-action` replaces its compiled hover controller.

## Effects

| Effect | Public contract | Behavior |
| --- | --- | --- |
| Counted opening | `data-sds-opening` / `createOpening(element)` | 001–100 over 3600 ms, 450 ms hold, stepped orange exit; about 5.5 seconds total |
| Block wipe | `createBlockWipe(element)` | Twelve vertical columns; 900 ms each and 45 ms stagger |
| Word grid | `data-sds-word-grid` / `createWordGrid(element)` | Colorful word pixels, monochrome background; finite sequence and replay |
| Square orbit | `data-sds-square-orbit` / `createSquareOrbit(element)` | Upright squares follow four straight sides; 32-second circuit |
| Lottie studies | `data-sds-motion-panels` / `createMotionPanels(element)` | Five square panels, four drawings each; finite entrance and hover replay |
| Gravity words | `data-sds-float` / `initGravityText(scope, options)` | Slow letter drift; returns on leave or pointer release |
| Square actions | `initSquareActions(scope)` / `data-sds-action` | Square corners and an accent light that persists after pointer/keyboard entry |
| Closing | `data-sds-closing` / `createClosing(element)` | Short reveal and complete native-flow fallback |
| Content / media | `data-sds-reveal` / `data-sds-media` | Local entrance or at most 18 px of image travel |

These are browser-side progressive enhancements. `initScenes(scope)` discovers declarative scenes after DOM insertion. Scene controllers expose `stop`, `sync` and `destroy`; opening, wipe, grid and closing also expose `play`. The wipe exposes `reset`. Sound is separate and never starts with these effects.

## Counted opening

Copy the full markup from the atlas or expressive recipe. Keep `hidden` and `aria-hidden="true"`: the sequence is decorative, dismissible with Escape, and never required to read the page. The 20 px Geist Mono counter stays at the bottom-left, 34 px above the screen edge, with a thin progress line below. Its counter measures the timed introduction, not downloaded bytes. Do not claim network progress.

`data-sds-opening-count="3600"` sets the count duration, bounded to 2000–6000 ms. `data-sds-opening-hold="450"` sets the hold, bounded to 200–1500 ms. A recovery deadline is count + hold + 2400 ms. Stop cancels timers, frames and column animations. Replaying an active intro does not create another sequence.

The copy is “I know you’re using AI to code.” and “Let’s give it a point of view.” Both use Inter. Adapt the joke to the project. `--sds-opening-color` follows the primary accent; SDS uses orange. Its column exit follows the supplied local recording, which is excluded from distribution.

## Colorful words and square circuit

The grid shares the 3 × 5 alphabet in `js/word-grid-data.js`. Set `data-sds-words="SDS|SYLHET|DESIGN|CREATE|ART"` or five short project words. `data-sds-grid-labels` supplies tiny labels. Active pixels use primary accent and optional `--sds-motion-secondary`. Background shapes use paper and low-opacity ink only. `data-sds-grid-hold` defaults to 1800 ms, `data-sds-grid-duration` to 640 ms. Keep Replay study. Reduced motion shows the first word.

The expressive orbit keeps `.intro_logo-parent`, `.intro_logo`, `.intro-orbit_track` and `.intro-orbit_item`. Mark the parent `data-sds-square-orbit`. The controller wraps satellites in `.sds-orbit-carrier` so path movement cannot overwrite inner reveals. Custom markup may use `data-sds-orbit-item`. Pure `squarePerimeterPoint` and `SQUARE_ORBIT_PATH` share its geometry. `data-sds-orbit-duration="32000"` accepts 12000–90000 ms. Playback pauses offscreen; still mode keeps a complete square composition.

## Five Lottie studies

`sylhet/motion-panels.json` supplies the actual Form, Craft, Response, Nature and Rhythm groups: twenty distinct existing assets. Each `.sds-motion-panel` is square and a `data-sds-lottie-host`. Its drawings use `data-sds-play="hover"` and include static SVG posters in HTML.

`createMotionPanels` replays the first drawing in each card on first view. `replayLottie(element)` can queue a drawing still loading; `pauseLottie(scope)` stops a group. The shared budget remains three players. Hover/focus does not restart an already playing pass. Six grid columns arrange three cards above and two centered below. `--sds-panel-width` can override the width. Its default considers viewport height so headlines stay visible.

## Gravity words

For the showcase behavior:

```html
<html data-sds-text="gravity" data-sds-actions="square">
  <!-- ordinary semantic headings, paragraphs, links and buttons -->
</html>
```

With that root setting, `initGlyphs()` delegates to gravity for ordinary copy and navigation. Or mark one block `data-sds-float` and load the normal SDS entry. Direct use is `initGravityText(document, {automatic: true})`. The expressive preset waits for retained text setup before binding.

Source words keep natural shaping and original hit targets. A shared decorative overlay draws grapheme copies from DOM ranges, including in clipped headings, buttons and the SDS nav wordmark. The ordinary source stays in the accessibility tree. Drift is eased and bounded: at most 42 px upward, 19.32 px sideways and 7 degrees. Small type moves less. Copies return and disappear after leave, pointer release, blur, reduced motion or motion-off. Idle copy has no frame loop.

Fields, editable content, code, long code-like tokens and `data-sds-no-float` areas are excluded. Test real languages and selection. The earlier `data-sds-glyphs` symbol substitution remains available outside gravity mode; never layer both effects over the same text.

## Square actions and ending

`.sds-btn` and `.sds-scene-button` have square corners. `initSquareActions` also supports retained `.btn` and custom `data-sds-action` controls. Accent lighting lasts for the page visit, without storage. It is decorative: no false `aria-pressed` or success state. Normal keyboard focus remains visible.

The expressive closing requires `.canvas`, `data-footer-trigger` and `.nav_outro`. Keep them from the recipe. The maintained preset ends the reveal plane after the photo section so it cannot cover the finale. Procedural artwork needs no video. Keep the semantic `sds-closing` fallback, real CTAs, Z7 Studio authorship and Designed through SDS badge.

Runtime SVG/Lottie paths resolve relative to `sylhet/vendor/expressive/`. The recipe and full kit are checked on isolated local servers. Local servers bind to 127.0.0.1; publication is separate.

Read the [reproduction prompt](../prompts/recreate-expressive-site.md), [native atlas](../recipes/motion-atlas.html) and [motion guidance](motion.md). Primary restraint references: [Carbon motion](https://www.carbondesignsystem.com/building-blocks/foundations/motion/overview) and [W3C interaction animation guidance](https://www.w3.org/WAI/WCAG22/Understanding/animation-from-interactions.html). A successful build is not an accessibility certification.

Utility navigation such as documentation topic links is marked `data-sds-no-float` to keep labels readable. Small expressive words use a gentler drift (about 3–4 px and two degrees); display text retains the larger bounded motion. Mobile stack notes and statistics wrap inside their columns, and the ending hides its underlying duplicate footer while the closing navigation panel is open. These adjustments ship in the public expressive stylesheet too.
