# `Astral`
[🔗](https://github.com/elixir-volt/astral/blob/v0.7.0/lib/astral.ex#L1)

Volt-powered static site generation for Elixir applications.

Astral is intentionally separate from Volt. Volt owns generic asset building,
dev-server, and HMR primitives; Astral will own site concepts such as pages,
routes, layouts, content, and static output.

# `asset_path`

```elixir
@spec asset_path(Astral.Site.t() | Astral.Config.t(), String.t()) :: String.t()
```

Return the browser path for a Volt-managed source asset.

# `build`

```elixir
@spec build(keyword() | Astral.Config.t()) ::
  {:ok, Astral.BuildResult.t()} | {:error, term()}
```

Build a static Astral site.

# `dev`

```elixir
@spec dev(keyword()) :: Supervisor.on_start()
```

Start a supervised Astral development server.

# `version`

```elixir
@spec version() :: String.t()
```

Return the package version.

---

*Consult [api-reference.md](api-reference.md) for complete listing*