Assets, styling & theming

Sites are styled with Tailwind CSS driven by a themeable set of design tokens, and they host their own assets — images, documents, video — on the platform's CDN.

Styling with Tailwind

You style pages with Tailwind utility classes. The stylesheet is generated for you when you publish based on what your templates actually use, so you don't manage a build pipeline for CSS.

Theming

A site's look is driven by a theme — a design-token file defining colors, fonts, spacing, and the like. Changing the theme restyles the site consistently, which makes it easy to match a brand or reskin a site without editing every page. It's also how the AI agent keeps a site visually coherent as it builds.

Fonts

Google Fonts and Font Awesome are available, so you can use a wide range of typefaces and icons without hosting them yourself.

Assets

Static assets are hosted for you and served from the CDN:

• Immutable, cache-busted URLs — when a file changes it gets a fresh URL, so caches never serve a stale version.
• Responsive images — appropriately sized variants are generated so pages load the right image for each screen.
• Public vs. private — files under the assets area are publicly addressable by URL; anything sensitive should be a database attachment served through access control instead.

Generated files

Two files in a site's assets — the compiled stylesheet and the client-side script bundle — are produced by the platform on every publish. Don't hand-edit them; they're regenerated each time.

Bringing your own CSS build

If your own toolchain already produces the stylesheet — most often when a site is largely a bundled single-page app — you can turn the platform's CSS build off in the site's root configuration. The stylesheet then becomes an ordinary asset that you publish exactly as your bundler wrote it, instead of being regenerated, and the theme file is no longer required. Everything else about the site is unchanged. Leave the build on for normal Liquid sites: it's what makes Tailwind classes in your templates work.