TileDownv0.5.9
Article

Interactive Tiles

Typed tiles can render scoped browser behavior while the rest of the page remains static.

TileDown pages are static files, but a typed tile can emit the browser behavior it owns. That keeps interactivity explicit and local to the content that needs it.

The counter below is rendered by the generator and runs entirely in the browser. It is not a framework dependency and it does not require build-time JavaScript.

0

Not every tile ships JavaScript. The embed tile is static: you keep a safe provider URL in Markdown and the generator emits a responsive, sandboxed iframe with no script of its own. Here is one, selected with the utmost rigor:

Why the boundary matters

  • The engine and CLI stay Swift.
  • The generated page can still contain visitor-side JavaScript where a tile needs it.
  • Browser behavior can be tested with Playwright against the generated output.

Browser-tested output

The website check clicks this kind of tile in Chromium, so generated behavior is verified where visitors will use it.

TileDown Updates

Stay updated with every exciting new feature we bring to TileDown, the Markdown-first way to build sites you truly own.

View Markdown source
index.md
---
title: Interactive Tiles
date: 2026-06-01
description: Typed tiles can render scoped browser behavior while the rest of the page remains static.
tags: Tiles, Browser, JavaScript
image: /assets/post-interactive.svg
imageDark: /assets/post-interactive-dark.svg
---
# Interactive Tiles

TileDown pages are static files, but a typed tile can emit the browser behavior
it owns. That keeps interactivity explicit and local to the content that needs it.

The counter below is rendered by the generator and runs entirely in the browser.
It is not a framework dependency and it does not require build-time JavaScript.

:::tile counter
label: Count this tile
:::

Not every tile ships JavaScript. The embed tile is `static`: you keep a safe
provider URL in Markdown and the generator emits a responsive, sandboxed iframe
with no script of its own. Here is one, selected with the utmost rigor:

:::tile embed
url: https://www.youtube.com/watch?v=dQw4w9WgXcQ
title: A rigorously chosen reference video
aspectRatio: 16/9
:::

## Why the boundary matters

- The engine and CLI stay Swift.
- The generated page can still contain visitor-side JavaScript where a tile needs it.
- Browser behavior can be tested with Playwright against the generated output.

:::tile callout
title: Browser-tested output
body: The website check clicks this kind of tile in Chromium, so generated behavior is verified where visitors will use it.
:::