Changelog

Copy Markdown View Source

0.7.0 - 2026-10-05

Added

  • Require Volt 0.21. The dev server gives Volt a way to render pages, so that with Volt's morph setting each open page is told what changed instead of requesting itself again: its text, the attributes of <html> and <body>, and metadata in <head> update in place.
  • An island whose props changed on the server re-renders in place with the new props, instead of the page reloading. Vue, React and Solid islands keep their state. A Svelte island is mounted again, because props passed to mount are not reactive, so its state resets.

0.6.0 - 2026-10-03

Breaking changes

  • Require Volt 0.20. Volt now reads JavaScript formatter options from the :volt key of .formatter.exs and raises on a keyword list under config :volt, :format. Move a site's options:

    # .formatter.exs
[
  plugins: [Astral.Formatter, Volt.Formatter],
  volt: [semi: true, single_quote: false]
]

    mix astral.install writes them there. See Volt's changelog for the rest of 0.20, including externals staying as imports in ES module output.

Added

  • With Volt 0.20, saving a page, layout, component or collection entry reloads only the open pages whose HTML changed, instead of every page.

  • Pages can be updated in place instead of reloaded, keeping scroll position and mounted islands, with Volt's opt-in setting:

    config :volt, :server, morph: [preserve: "[data-astral-island]"]

Fixed

  • The basic example resolves its dependencies and passes mix check again. Its lockfile predated Volt 0.19, and its lint plugins were atoms, which Volt 0.19 rejects.

0.5.1 - 2026-10-01

Fixed

  • An image source rewritten in place while mix astral.dev runs now produces variants of its new pixels. libvips cached the decoded file by name, so the variant got a new name from the new content hash but kept the old pixels, and a later build copied that stale variant from the image cache. Sources are now decoded from the bytes that were hashed.

Documentation

  • Document MDEx plugins in markdown(plugins: [...]). They already ran on pages and collection entries; a test now covers it.

0.5.0 - 2026-10-01

Breaking changes

  • A <script> or <style> in an .astral template is rendered where it is written, as in any HEEx template. To build one with Volt, mark it with :type={Astral.Script} or :type={Astral.Style}, following Phoenix's <script :type={Phoenix.LiveView.ColocatedJS}>. Add :type to existing blocks that should stay Volt modules.

0.4.1 - 2026-10-01

Added

  • mix astral.dev applies changes to astral.config.exs and the project's Elixir sources without a restart. A config change starts the server with the new config, and a source change recompiles the project. Open pages reload once the change is in. A broken config or a compile error shows in Volt's error overlay, titled "Config error" or "Compile error", and leaves the running server in place.

Changed

  • Require Volt 0.19.3, which accepts compiler diagnostic structs in its error overlay and resolves OXC runtime helpers.

Fixed

  • Locate syntax and compile errors in development at the file and line they carry, without the loader's stacktrace.

0.4.0 - 2026-09-30

Breaking changes

  • Require Volt 0.19. Lint :plugins, :env, and :globals in config :volt, :lint take string names, such as plugins: ["typescript", "jsx-a11y"]; see Volt's changelog.
  • Require MDEx 0.14.1 and Lumis 0.10 for syntax highlighting. Lumis 0.10 installs each language's parser as its own lumis_wasm_* package; add one for every language your code fences use.

Fixed

  • Show development render errors in Volt's error overlay instead of crashing the request with an empty 500. Exceptions raised while rendering .astral pages, layouts, and components are reported with Volt.HMR.error/3 with their source file, line, frame, and stacktrace, and the overlay clears once the page renders again. The error page keeps the error as plain text for clients without JavaScript.
  • Report the component's own .astral file in stacktraces instead of the page or layout that rendered it.

0.3.2 - 2026-09-16

Added

  • Add site-scoped markdown options for MDEx rendering across pages, collections, and feeds, including optional Lumis syntax highlighting with light/dark themes.
  • Add Astral.Formatter for mix format: format Elixir setup blocks, HEEx templates, and embedded JavaScript/TypeScript through Volt. The installer configures the plugin and .astral inputs for new and existing projects.

Fixed

  • Preserve whitespace between highlighted code tokens and inline elements when injecting the development HMR client.

0.3.1 - 2026-09-15

Added

  • Add Astral.Plugin.LLMs for metadata-driven llms.txt generation in builds and development, with automatic discovery, exclusions, curated sections, and external links. New starters enable it with the project title.

Fixed

  • Include Volt's shared browser declarations in starter TypeScript configurations instead of generating application-local ImportMeta definitions.

0.3.0 - 2026-09-15

Breaking changes

  • Require explicit islands do component :vue, "path.vue" end declarations for runtime-selected components that cannot be discovered from literal template references.

Changed

  • Replace generated TypeScript island files in assets/.astral/islands with shared virtual component entries; serialize instance props and hydration settings in HTML.
  • Compose development assets through one supervised Volt session and use Volt's complete production build API.
  • Normalize configured asset entries to lists and support multiple entries.
  • Build browser assets before rendering documents so asset URLs can be used in HTML, island props, and generated data routes without rendering pages twice.

Fixed

  • Include production island stylesheet dependencies in the active document head, including dependencies first encountered inside inert slot templates.
  • Mount late-appearing nested islands when another instance has already loaded their shared component entry.
  • Respect explicitly disabled Tailwind configuration during builds and development startup.
  • Reject colliding destinations within pages or generated routes instead of silently overwriting documents, while preserving generated-route precedence over pages.
  • Coordinate concurrent first renders of a template so requests do not fail while its module is being compiled.
  • Resolve component-relative SVG references from the component file while preserving the caller's source context in slots.

Security

  • Require Bandit 1.12.5 or later to address HTTP/2 header validation and connection-window starvation (CVE-2026-75484, CVE-2026-74836).
  • Require Igniter 0.8.4 or later to prevent terminal escape injection through package metadata in installer confirmation prompts (CVE-2026-82584).
  • Reject symlinked document and image destinations, including copied public links, to prevent generated output from writing outside the output directory.
  • Reject symlinked output-directory parents within the project before clearing the previous build.

Compatibility

  • Require Volt 0.18 for the shared build and supervised development-session APIs.

0.2.6 - 2026-09-04

Fixed

  • Exclude generated assets/.astral/ browser entries from the formatter configuration created by the Astral installer.

0.2.5 - 2026-09-04

Fixed

  • Prevent generated client-island entries from causing repeated full-page reloads in the development server.

Changed

  • Update Volt to 0.17.11 for configurable watcher exclusions and normalized filesystem events.

0.2.4 - 2026-09-03

Added

  • Added Astral- and Volt-focused AGENTS.md guidance to starter projects while preserving existing project instructions.
  • Added starter .gitignore coverage for static output, browser dependencies, generated island entries, and local environment files.

Changed

  • Starter pages, layouts, and generated README files now use the Mix application name instead of generic Astral branding.
  • Replaced Mix's placeholder README in new sites with concise Astral development and build instructions while preserving existing project documentation.
  • Updated setup documentation with the one-command mix igniter.new my_site --install astral project creation flow.

0.2.3 - 2026-07-10

Added

  • Added nested hydrated island support for islands rendered inside another island's slot.
  • Hardened island tests for nested JSON-safe props, repeated same-component mounts, async mount idempotency, and static browser integration coverage.

Fixed

  • Reused content-addressed compiled template modules instead of creating a new BEAM module and atom on every render.
  • Hardened public-file, image-cache, island-component, page, plugin-route, and output-directory path boundaries.
  • Prevented unsafe explicit island IDs and collisions between explicit and generated island IDs.
  • Made client={:media} islands hydrate when their media query starts matching after page load.
  • Made React island mounts synchronous so nested island entry scripts are activated reliably.
  • Made mix astral.dev reject invalid command-line options consistently with mix astral.build.

0.2.2 - 2026-07-07

Added

  • Documented and tested mixed Vue, Svelte, React, and Solid islands on the same page, including repeated same-framework islands and mixed client directives.
  • Added Solid island build support using .solid.jsx and .solid.tsx component filenames.

Changed

  • Production island assets now build as ES modules and share common framework/runtime chunks through Volt 0.15.5.
  • Moved island browser tests under test/astral/islands/browser/ and added Elixir build/integration coverage for mixed framework islands.
  • Updated Volt to 0.15.5.

0.2.1 - 2026-07-06

Added

  • Added Volt browser tests for island runtime behavior and framework adapters across React, Vue, Solid, and Svelte.

Changed

  • Updated Volt to 0.15.2 for package import specifier resolution used by Svelte's browser runtime internals.

0.2.0 - 2026-06-29

Changed

  • Rebuilt the configuration DSL on the shared dsl package while preserving existing site do ... end syntax and generated route behavior.

0.1.8 - 2026-06-29

Fixed

  • Preserved external <script src="..."> tags in .astral templates while still extracting inline script blocks into Volt modules.

0.1.7 - 2026-06-28

Changed

  • Replaced the collections do ... end config wrapper with top-level collection declarations.

0.1.6 - 2026-06-28

Changed

  • Replaced the top-level plugins [...] config declaration with singular plugin declarations for cleaner config files.

0.1.5 - 2026-06-28

Changed

  • Dynamic route params rendered in @params are now atom-keyed, matching setup-declared route params and schema-normalized entry data.

0.1.4 - 2026-06-28

Added

  • Top-level astral.config.exs declarations for site configuration, preserving legacy site do ... end support.

Changed

  • Starter scaffolding, the basic example, and documentation now use the top-level config style.

0.1.3 - 2026-06-28

Added

  • Static HEEx children for client islands, passed to framework runtimes through the default slot/children channel.
  • Server-rendered Iconify icons through PhoenixIconify's <.icon> component in .astral templates.
  • Inline local SVG files through <.svg src="..." />, resolved with Volt asset aliases and rendered as HTML-safe SVG.
  • Phoenix-shaped get declarations in astral.config.exs for one-off generated static routes, with Plug-compatible middleware via plug.
  • A userland head metadata component pattern in the basic example and pages/layouts guide.
  • Root custom 404 pages (pages/404.{md,html,astral}) that build to dist/404.html and return 404 in development.
  • Documentation and tests for deterministic static output precedence: public files, then pages, then generated routes.
  • A custom 404 page in the basic example site.
  • Clearer content collection documentation for schema defaults and userland tag page patterns.
  • Setup-declared dynamic .astral page paths through strict Astral.Route.Path values and the path/1 setup helper.
  • Clearer develop/build/configuration docs covering dev server options, static build preview expectations, and metadata placement.
  • Editor setup, TypeScript, and environment variable guides that map Astral's Elixir site layer to Volt browser tooling.
  • Clearer plugins/integrations documentation separating Astral site plugins from Volt browser asset plugins.
  • Clearer routing, static endpoint, and middleware-scope documentation after auditing Astro's routing/endpoints/middleware guides.
  • Navigation documentation covering current i18n, prefetch, and view-transition boundaries.
  • Styling and browser-code documentation covering current CSS, font, syntax-highlighting, script, and framework-island boundaries.
  • Markdown, content, and data-fetching documentation covering current MDX, Markdown import, content loader, and live collection boundaries.
  • Server/runtime documentation covering current on-demand rendering, server island, action, session, and route caching boundaries.
  • Deployment documentation covering current static-host deployment and future adapter boundaries.
  • Backend, authentication, and testing documentation covering current composition boundaries.
  • Image documentation covering current build-time image service and future adapter/CDN boundaries.

Changed

  • Collection helpers, feed entry authors/dates, and collection sitemap dates now use schema-normalized entry.data instead of falling back to raw string-keyed frontmatter metadata.
  • Schema-less collections now expose empty normalized entry.data while preserving raw frontmatter in entry.metadata.

0.1.2 - 2026-06-26

Added

  • Dynamic file routes with route diagnostics.
  • Ecto-style content collection schema fields.
  • Markdown rendering with Astral HEEx components.
  • Optimized local and remote image pipeline with image, picture, figure, metadata, Markdown image, dev-server, and collection image field support.
  • Client-only islands for Vue, Svelte, React, and Solid with framework-specific HEEx components.
  • Island client directives for :load, :idle, :visible, and :media.
  • JSON-safe island props handling through JSON-shaped values, JSONCodec structs, and Jason encoders.
  • Type-aware Volt JavaScript checks for Astral island runtime assets.
  • Vue and React islands in the basic example site.

Changed

  • All Volt-supported island adapters are enabled by default.
  • Astral island runtime assets are maintained as TypeScript files under priv/islands.

0.1.1 - 2026-06-26

Added

  • HEEx-first .astral templates for pages, layouts, and local components.
  • Parser-backed .astral <style> and <script> extraction through Volt embedded modules.
  • Example site pages, layouts, and components that dogfood .astral templates.

0.1.0 - 2026-06-25

Initial Astral development release.

Added

  • Static HTML and Markdown build pipeline.
  • Elixir astral.config.exs site DSL.
  • MDEx-backed Markdown and frontmatter support.
  • EEx layouts with page, metadata, route, and site assigns.
  • Per-page layout selection and layout disabling.
  • Plug/Bandit development server composed with Volt.
  • mix astral.dev and mix astral.build tasks.
  • Astral.asset_path/2 for Volt-managed layout assets.
  • examples/basic runnable site with TypeScript, CSS, layouts, Markdown, public files, and Volt lint/format configuration.
  • Igniter-powered starter site scaffolding through mix astral.new, mix astral.install, and mix igniter.install astral.