JAAMD
Edit this page

Migrating

Changes that need action, by the version you upgrade from. To upgrade, see Upgrading.

From @lancher-dev/jaad

JAAD and JAAMD moved to the @jaamd scope. The old packages are deprecated and receive no further releases.

Replace the dependency:

npm uninstall @lancher-dev/jaad
npm install @jaamd/jaad

Then replace @lancher-dev/jaad with @jaamd/jaad in every import: astro.config.*, src/content.config.*, jaad.config.ts, and any page using @jaamd/jaad/layouts/Page.astro or @jaamd/jaad/advanced. A project that imports @lancher-dev/jaamd directly needs @jaamd/jaamd instead.

The documentation moved from jaad.lancher.dev to jaamd.org/docs/jaad: update the links in AGENTS.md if create-jaad generated one.

From 0.9

Tailwind on your own pages

0.9 left Tailwind to the site: plugin in astro.vite.plugins and a stylesheet importing tailwindcss. Replace both with the option:

// jaad.config.ts
defineJaadConfig({ title: 'My Project', tailwind: true })
  • Remove @tailwindcss/vite from astro.vite.plugins. If it stays, JAAD leaves it and skips its own.
  • Remove CSS that imports tailwindcss for pages using Page: it adds a second preflight and Tailwind’s default fonts over JAAD’s. Utilities now read JAAD’s tokens directly (bg-surface, text-primary), with no @theme to write.
  • Pages on a local layout keep their own @import "tailwindcss";.
  • tailwindcss and @tailwindcss/vite stay in your devDependencies.

See Styles.

Component classes

JAAD’s markup no longer uses Tailwind utilities: every element has a jaad-* or docs-* class, styled in @layer components. CSS that targeted utilities in JAAD’s markup needs the new names:

Before Now
body utilities .jaad-body
default frame wrapper contents .docs-frame
.theme-icon-to-dark / -light .jaad-theme-icon-to-dark / -light
active ToC link class [aria-current="location"]

dist/jaad.css no longer contains stray utilities (.hidden, .block, .relative, …). Pages that used them without Tailwind need tailwind: true or their own CSS.

From 0.8

JAAD ships a precompiled stylesheet and no longer depends on Tailwind. Until 0.8 its Tailwind plugin also generated the utilities used in your own pages; from 0.9 those classes are missing unless the site provides Tailwind. Use tailwind: true (see From 0.9).

From 0.7

@jaamd/jaad/layouts/Base.astro is gone. It forwarded every prop to the page layout: change the import to @jaamd/jaad/layouts/Page.astro.