volt

0.22.0

0.23.0 0.22.1 0.22.0 0.21.0 0.20.0 0.19.4 0.19.3 0.19.2 0.19.1 0.19.0 0.18.1 0.18.0 0.17.11 0.17.10 0.17.9 0.17.8 0.17.7 0.17.6 0.17.5 0.17.4 0.17.3 0.17.2 0.17.1 0.17.0 0.16.0 0.15.5 0.15.4 0.15.3 0.15.2 0.15.1 0.15.0 0.14.12 0.14.11 0.14.10 0.14.9 0.14.8 0.14.7 0.14.6 0.14.5 0.14.4 0.14.3 0.14.2 0.14.1 0.14.0 0.13.1 0.13.0 0.12.0 0.11.3 0.11.2 0.11.1 0.11.0 0.10.9 0.10.8 0.10.7 0.10.6 0.10.5 0.10.4 0.10.3 0.10.2 0.10.1 0.10.0 0.9.2 0.9.1 0.9.0 0.8.4 0.8.3 0.8.2 0.8.1 0.8.0 0.7.1 0.7.0 0.6.5 0.6.4 0.6.3 0.6.2 0.6.1 0.6.0 0.5.0 0.4.3 0.4.2 0.4.1 0.4.0 0.3.0 0.2.0 0.1.0

Elixir-native frontend build tool — dev server, HMR, and production builds powered by OXC and Vize.

HexDocs Report package

Current section

Files

Jump to

Documentation 85 Versions 16 Dependencies Dependants Files Activity

volt mix.exs

Raw

mix.exs

defmodule Volt.MixProject do
  use Mix.Project

  @version "0.22.0"
  @source_url "https://github.com/elixir-volt/volt"

  def project do
    [
      app: :volt,
      version: @version,
      elixir: "~> 1.18",
      start_permanent: Mix.env() == :prod,
      deps: deps(),
      aliases: aliases(),
      elixirc_paths: elixirc_paths(Mix.env()),
      dialyzer: [plt_add_apps: [:mix, :ex_unit], flags: [:no_opaque]],
      name: "Volt",
      description:
        "Elixir-native frontend build tool — dev server, HMR, and production builds powered by OXC and Vize.",
      source_url: @source_url,
      homepage_url: @source_url,
      package: package(),
      docs: docs()
    ]
  end

  def application do
    [
      extra_applications: [:logger],
      mod: {Volt.Application, []}
    ]
  end

  defp elixirc_paths(:test), do: ["lib", "test/support"]
  defp elixirc_paths(_env), do: ["lib"]

  defp deps do
    [
      {:reach, "~> 2.6.1", only: [:dev, :test], runtime: false},
      {:glob_ex, "~> 0.1.12"},
      {:oxc, "~> 0.18.1"},
      {:vize, "~> 0.17.1"},
      {:oxide_ex, "~> 0.2.2"},
      {:quickbeam, "~> 0.11.2"},
      {:dotenvy, "~> 1.1"},
      {:floki, "~> 0.38"},
      {:plug, "~> 1.16"},
      {:mime, "~> 2.0"},
      {:websock_adapter, "~> 0.5"},
      {:file_system, "~> 1.0"},
      {:jason, "~> 1.4"},
      {:json_codec, "~> 0.3"},
      {:lumis, "~> 0.10", optional: true},
      {:lumis_wasm_typescript, "~> 0.26", only: :test},
      {:igniter, ">= 0.8.4 and < 1.0.0", optional: true},
      {:npm, "~> 0.7.6"},
      {:dialyxir, "~> 1.4", only: [:dev, :test], runtime: false},
      {:credo, "~> 1.7", only: [:dev, :test], runtime: false},
      {:ex_slop, "~> 0.4", only: [:dev, :test], runtime: false},
      {:ex_dna, "~> 1.1", only: [:dev, :test], runtime: false},
      {:ex_doc, "~> 0.35", only: :dev, runtime: false},
      {:makeup_js, "~> 0.1", only: :dev, runtime: false},
      {:bandit, ">= 1.12.5 and < 2.0.0", only: :test},
      {:playwright_ex, "~> 0.5", only: :test}
    ]
  end

  defp aliases do
    [
      lint: [
        # `mix format` loads Volt.Formatter from the existing build and only
        # compiles when the module is missing, so a cached build would format
        # with stale plugin code.
        "compile",
        "format --check-formatted",
        "volt.js.check --type-aware --type-check",
        "credo --strict",
        "ex_dna --min-mass 20",
        "reach.check --arch --dead-code --smells --strict",
        "dialyzer"
      ],
      setup: ["deps.get", "volt.priv.vendor priv/ts"],
      "hex.build": ["cmd mix volt.priv.vendor priv/ts", "hex.build"],
      "hex.publish": ["cmd mix volt.priv.vendor priv/ts", "hex.publish"],
      ci: ["lint", "cmd env MIX_ENV=test mix test"]
    ]
  end

  defp package do
    [
      licenses: ["MIT"],
      links: %{"GitHub" => @source_url},
      files: ~w[lib priv guides mix.exs README.md CHANGELOG.md LICENSE]
    ]
  end

  defp docs do
    [
      main: "readme",
      source_ref: "v#{@version}",
      extras: [
        "README.md",
        "CHANGELOG.md",
        "guides/introduction/getting-started.md",
        "guides/introduction/why-volt.md",
        "guides/features/features.md",
        "guides/features/frameworks.md",
        "guides/features/tailwind.md",
        "guides/features/hmr.md",
        "guides/features/code-splitting.md",
        "guides/features/css-modules.md",
        "guides/features/static-assets.md",
        "guides/features/environment-variables.md",
        "guides/features/glob-imports.md",
        "guides/features/plugins.md",
        "guides/features/formatting-and-linting.md",
        "guides/features/testing.md",
        "guides/deployment/production-builds.md",
        "guides/migration/from-esbuild.md",
        "guides/cheatsheets/configuration.cheatmd",
        "guides/cheatsheets/cli.cheatmd"
      ],
      groups_for_extras: [
        Introduction: ~r/guides\/introduction\//,
        Features: ~r/guides\/features\//,
        Deployment: ~r/guides\/deployment\//,
        Migration: ~r/guides\/migration\//,
        Cheatsheets: ~r/guides\/cheatsheets\//
      ],
      groups_for_modules: [
        Core: [Volt, Volt.Preload, Volt.Config, Volt.Plugin],
        "Dev Server": [Volt.DevServer, Volt.Watcher, Volt.HMR, Volt.Dev.ConsoleForwarder],
        "Production Build": [Volt.Builder, Volt.Builder.Bundle, Volt.ChunkGraph, Volt.PublicDir],
        "Tailwind CSS": [Volt.Tailwind],
        CSS: [Volt.CSS.Imports, Volt.CSS.Modules],
        Plugins: [
          Volt.Plugin.Vue,
          Volt.Plugin.Svelte,
          Volt.Plugin.React,
          Volt.Plugin.Solid,
          Volt.Plugin.EmbeddedModule,
          Volt.Plugin.Helpers,
          Volt.PluginRunner
        ],
        JavaScript: [
          Volt.Assets,
          Volt.Env,
          Volt.JS.Runtime,
          Volt.JS.Format,
          Volt.NPM,
          Volt.Priv
        ],
        Formatting: [Volt.Formatter, Volt.Format],
        Testing: [
          Volt.Test.Assertions,
          Volt.Test.BrowserRunner,
          Volt.Test.Case,
          Volt.Test.Config,
          Volt.Test.Discovery,
          Volt.Test.ExUnit,
          Volt.Test.Inline,
          Volt.Test.Lines,
          Volt.Test.Plugin,
          Volt.Test.Result,
          Volt.Test.Result.Metadata,
          Volt.Test.Result.SerializedError,
          Volt.Test.Result.Test,
          Volt.Test.Runner,
          Volt.Test.Shared,
          Volt.Test.Sigils
        ],
        "Mix Tasks": [
          Mix.Tasks.Volt.Build,
          Mix.Tasks.Volt.Dev,
          Mix.Tasks.Volt.Lint,
          Mix.Tasks.Volt.Js.Format,
          Mix.Tasks.Volt.Js.Check,
          Mix.Tasks.Volt.Install
        ],
        "Internals: Builder": [
          Volt.Builder.CSS,
          Volt.Builder.Collector,
          Volt.Builder.Collector.State,
          Volt.Builder.Compiler,
          Volt.Builder.Context,
          Volt.Builder.BuildContext,
          Volt.Builder.Dependencies,
          Volt.Builder.Externals,
          Volt.Builder.Output,
          Volt.Builder.OutputContext,
          Volt.Builder.OutputFile,
          Volt.Builder.Resolver,
          Volt.Builder.Result,
          Volt.Builder.Rewriter,
          Volt.Builder.Writer,
          Volt.HTMLEntry,
          Volt.Pipeline,
          Volt.Pipeline.Result
        ],
        "Internals: Config": [
          Volt.Config.Build,
          Volt.Config.Profile,
          Volt.Config.Server
        ],
        "Internals: CSS": [
          Volt.MIME,
          Volt.CSS.AST,
          Volt.CSS.AssetURLRewriter
        ],
        "Internals: Dev Server": [
          Volt.Cache,
          Volt.DevServer.CacheEntry,
          Volt.DevServer.Config,
          Volt.Dev.ConsoleForwarder.Payload
        ],
        "Internals: HMR": [
          Volt.HMR.Boundary,
          Volt.HMR.GlobGraph,
          Volt.HMR.ImportGraph,
          Volt.HMR.Message,
          Volt.HMR.StyleDependencies,
          Volt.HMR.StyleGraph,
          Volt.HMR.ModuleGraph,
          Volt.HMR.ModuleGraph.Node,
          Volt.HMR.Socket
        ],
        "Internals: JavaScript": [
          Volt.Assets.Query,
          Volt.JS.Asset,
          Volt.JS.AST,
          Volt.JS.Extensions,
          Volt.JS.Discovery,
          Volt.JS.Lint.Config,
          Volt.JS.ImportExtractor,
          Volt.JS.ImportExtractor.Result,
          Volt.JS.Package,
          Volt.JS.Patch,
          Volt.JS.PrebundleEntry,
          Volt.JS.PrebundleEntry.Export,
          Volt.JS.PrebundleEntry.Import,
          Volt.JS.Resolution,
          Volt.JS.Resolver,
          Volt.JS.Runtime.Bundler,
          Volt.JS.Runtime.Entry,
          Volt.JS.Runtime.Error,
          Volt.JS.Runtime.Installer,
          Volt.JS.Specifier,
          Volt.JS.Transforms.AssetURLs,
          Volt.JS.Transforms.DynamicImports,
          Volt.JS.Transforms.DynamicImports.Replacement,
          Volt.JS.Transforms.GlobImports,
          Volt.JS.Transforms.GlobImports.Call,
          Volt.JS.Transforms.GlobImports.File,
          Volt.JS.Transforms.ImportMetaEnv,
          Volt.JS.Transforms.Imports,
          Volt.JS.Transforms.Specifiers,
          Volt.JS.Transforms.Workers,
          Volt.JS.TSConfig,
          Volt.JS.Vendor
        ],
        "Internals: Support": [
          Volt.Application,
          Volt.ETS,
          Volt.Path,
          Volt.Tailwind.Loader,
          Volt.Tailwind.Resolver,
          Volt.URL
        ],
        "Internals: Plugin Options": [
          Volt.Plugin.Solid.CompilerOptions,
          Volt.Plugin.Solid.CompilerOptions.SolidOptions,
          Volt.Plugin.Svelte.CompilerOptions
        ]
      ],
      skip_undefined_reference_warnings_on: ["CHANGELOG.md"]
    ]
  end
end

Operator	Description	Example
name:	Match package name. Supports * wildcards and repo/package form	name:phx* or name:hexpm/phoenix
description:	Full-text search of package descriptions	description:auth
depends:	Packages depending on a given package. Supports repo:package form	depends:ecto or depends:hexpm:ecto
build_tool:	Filter by build tool	build_tool:mix
updated_after:	Packages updated after an ISO8601 datetime	updated_after:2025-01-01T00:00:00Z
extra:	Match custom metadata (key,value). Nested keys are separated by commas	extra:license,MIT