From bc0d1a5bad7a6a98ce4cd89cfad544b5a23210c7 Mon Sep 17 00:00:00 2001
From: Mitchell Hanberg <mitch@mitchellhanberg.com>
Date: Mon, 7 Jul 2025 06:54:30 -0400
Subject: [PATCH 1/3] feat!: bun, esbuild

Adds support for a `--js` option to add a JavaScript bundler.

Also changes the CLI flags and adds a default for the template engine
(defaults to eex now)
---
 README.md                                     |   7 +-
 lib/mix/tasks/tableau.new.ex                  | 103 ++++++++++++++----
 priv/templates/bun/assets/js/site.js          |   0
 priv/templates/bun/package.json               |  12 ++
 priv/templates/eex/lib/layouts/root_layout.ex |   3 +-
 priv/templates/esbuild/assets/js/site.js      |   0
 .../templates/heex/lib/layouts/root_layout.ex |   3 +-
 priv/templates/no_assets/extra/js/site.js     |   0
 priv/templates/primary/config/config.exs      |  43 ++++++--
 priv/templates/primary/gitignore              |   6 +-
 priv/templates/primary/mix.exs                |   8 +-
 .../temple/lib/layouts/root_layout.ex         |   3 +-
 12 files changed, 148 insertions(+), 40 deletions(-)
 create mode 100644 priv/templates/bun/assets/js/site.js
 create mode 100644 priv/templates/bun/package.json
 create mode 100644 priv/templates/esbuild/assets/js/site.js
 create mode 100644 priv/templates/no_assets/extra/js/site.js

diff --git a/README.md b/README.md
index 30746cf..21919a0 100644
--- a/README.md
+++ b/README.md
@@ -15,13 +15,14 @@ mix tableau.new <app_name> [<flags>]
 
 Flags
 
---template    Template syntax to use. Options are heex, temple, eex. (required)
---assets      Asset framework to use. Options are vanilla, tailwind. (optional, defaults to vanilla)
+--template    Template syntax to use. Options are heex, temple, eex. (optional, defaults to eex)
+--js          JS bundler to use. Options are vanilla, bun, esbuild (optional, defaults to vanilla)
+--css         CSS framework to use. Options are vanilla, tailwind. (optional, defaults to vanilla)
 --help        Shows this help text.
 --version     Shows task version.
 
 Example
 
 mix tableau.new my_awesome_site --template temple
-mix tableau.new my_awesome_site --template eex --assets tailwind
+mix tableau.new my_awesome_site --template eex --css tailwind
 ```
diff --git a/lib/mix/tasks/tableau.new.ex b/lib/mix/tasks/tableau.new.ex
index 58a181f..0404a1f 100644
--- a/lib/mix/tasks/tableau.new.ex
+++ b/lib/mix/tasks/tableau.new.ex
@@ -4,15 +4,16 @@ defmodule Mix.Tasks.Tableau.New do
 
   Flags
 
-  --template    Template syntax to use. Options are heex, temple, eex. (required)
-  --assets      Asset framework to use. Options are vanilla, tailwind. (optional, defaults to vanilla)
+  --template    Template syntax to use. Options are heex, temple, eex. (optional, defaults to eex)
+  --js          JS bundler to use. Options are vanilla, bun, esbuild (optional, defaults to vanilla)
+  --css         Asset framework to use. Options are vanilla, tailwind. (optional, defaults to vanilla)
   --help        Shows this help text.
   --version     Shows task version.
 
   Example
 
-  mix tableau.new my_awesome_site --template temple
-  mix tableau.new my_awesome_site --template eex --assets tailwind
+  mix tableau.new my_awesome_site
+  mix tableau.new my_awesome_site --template temple --js bun --css tailwind
   """
   @moduledoc @help
   @shortdoc "Generate a new Tableau website"
@@ -25,7 +26,8 @@ defmodule Mix.Tasks.Tableau.New do
     {opts, argv} =
       OptionParser.parse!(argv,
         strict: [
-          assets: :string,
+          js: :string,
+          css: :string,
           template: :string,
           help: :boolean,
           version: :boolean
@@ -33,7 +35,7 @@ defmodule Mix.Tasks.Tableau.New do
       )
 
     opts =
-      case Keyword.validate(opts, [:assets, :template, help: false, version: false]) do
+      case Keyword.validate(opts, [:css, :js, :template, help: false, version: false]) do
         {:ok, opts} ->
           opts
 
@@ -56,13 +58,21 @@ defmodule Mix.Tasks.Tableau.New do
 
     [app | _] = argv
     Mix.Generator.create_directory(app)
-    templates = Path.join(:code.priv_dir(:tableau_new), "templates")
+    templates = :tableau_new |> :code.priv_dir() |> Path.join("templates")
+
+    css =
+      if opts[:js] == "bun" and opts[:css] == "tailwind" do
+        "tailwind-bun"
+      else
+        opts[:css]
+      end
 
     assigns = [
       app: app,
       app_module: Macro.camelize(app),
       template: opts[:template],
-      assets: opts[:assets]
+      js: opts[:js],
+      css: css
     ]
 
     Mix.Generator.copy_template(
@@ -84,12 +94,17 @@ defmodule Mix.Tasks.Tableau.New do
     )
 
     Mix.Generator.create_file(Path.join(app, "_pages/.keep"), "")
+    Mix.Generator.create_file(Path.join(app, "_wip/.keep"), "")
+
     Mix.Generator.create_file(Path.join(app, "_posts/.keep"), "")
+    Mix.Generator.create_file(Path.join(app, "_draft/.keep"), "")
+
     Mix.Generator.create_file(Path.join(app, "extra/.keep"), "")
 
     for source <- Path.wildcard(Path.join(templates, "primary/**/*.{ex,exs}")) do
       target =
-        Path.relative_to(source, Path.join(templates, "primary"))
+        source
+        |> Path.relative_to(Path.join(templates, "primary"))
         |> String.replace("app_name", app)
 
       Mix.Generator.copy_template(source, Path.join(app, target), assigns)
@@ -99,7 +114,8 @@ defmodule Mix.Tasks.Tableau.New do
       "temple" ->
         for source <- Path.wildcard(Path.join(templates, "temple/**/*.{ex,exs}")) do
           target =
-            Path.relative_to(source, Path.join(templates, "temple"))
+            source
+            |> Path.relative_to(Path.join(templates, "temple"))
             |> String.replace("app_name", app)
 
           Mix.Generator.copy_template(source, Path.join(app, target), assigns)
@@ -108,57 +124,98 @@ defmodule Mix.Tasks.Tableau.New do
       "heex" ->
         for source <- Path.wildcard(Path.join(templates, "heex/**/*.{ex,exs}")) do
           target =
-            Path.relative_to(source, Path.join(templates, "heex"))
+            source
+            |> Path.relative_to(Path.join(templates, "heex"))
             |> String.replace("app_name", app)
 
           Mix.Generator.copy_template(source, Path.join(app, target), assigns)
         end
 
-      "eex" ->
+      template when template in ["eex", nil] ->
         for source <- Path.wildcard(Path.join(templates, "eex/**/*.{ex,exs}")) do
           target =
-            Path.relative_to(source, Path.join(templates, "eex"))
+            source
+            |> Path.relative_to(Path.join(templates, "eex"))
             |> String.replace("app_name", app)
 
           Mix.Generator.copy_template(source, Path.join(app, target), assigns)
         end
 
-      nil ->
+      value ->
         Mix.shell().error("""
-        The --template option is required.
+        Unknown template value: --template=#{value}
 
         See help text for more information.
         """)
 
         System.halt(1)
+    end
+
+    case opts[:js] do
+      "esbuild" ->
+        for source <- Path.wildcard(Path.join(templates, "esbuild/**/*.{css,js}")) do
+          target =
+            source
+            |> Path.relative_to(Path.join(templates, "esbuild"))
+            |> String.replace("app_name", app)
+
+          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+        end
+
+      "bun" ->
+        for source <- Path.wildcard(Path.join(templates, "bun/**/*.{css,js,json}")) do
+          target =
+            source
+            |> Path.relative_to(Path.join(templates, "bun"))
+            |> String.replace("app_name", app)
+
+          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+        end
+
+      js when js in ["vanilla", nil] ->
+        for source <- Path.wildcard(Path.join(templates, "no_assets/**/*.{js}")) do
+          target =
+            source
+            |> Path.relative_to(Path.join(templates, "no_assets"))
+            |> String.replace("app_name", app)
+
+          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+        end
+
+      js ->
+        Mix.shell().error("""
+        Unknown js value: --js=#{js}
+
+        See help text for more information.
+        """)
 
-      _ ->
-        Mix.shell().error("Unknown template value: --template=#{opts[:template]}")
         System.halt(1)
     end
 
-    case opts[:assets] do
+    case opts[:css] do
       "tailwind" ->
         for source <- Path.wildcard(Path.join(templates, "tailwind/**/*.{css,js}")) do
           target =
-            Path.relative_to(source, Path.join(templates, "tailwind"))
+            source
+            |> Path.relative_to(Path.join(templates, "tailwind"))
             |> String.replace("app_name", app)
 
           Mix.Generator.copy_template(source, Path.join(app, target), assigns)
         end
 
-      assets when assets in ["vanilla", nil] ->
+      css when css in ["vanilla", nil] ->
         for source <- Path.wildcard(Path.join(templates, "no_assets/**/*.{css}")) do
           target =
-            Path.relative_to(source, Path.join(templates, "no_assets"))
+            source
+            |> Path.relative_to(Path.join(templates, "no_assets"))
             |> String.replace("app_name", app)
 
           Mix.Generator.copy_template(source, Path.join(app, target), assigns)
         end
 
-      _ ->
+      css ->
         Mix.shell().error("""
-        Unknown assets value: --assets=#{opts[:assets]}
+        Unknown css value: --css=#{css}
 
         See help text for more information.
         """)
diff --git a/priv/templates/bun/assets/js/site.js b/priv/templates/bun/assets/js/site.js
new file mode 100644
index 0000000..e69de29
diff --git a/priv/templates/bun/package.json b/priv/templates/bun/package.json
new file mode 100644
index 0000000..2bf0a00
--- /dev/null
+++ b/priv/templates/bun/package.json
@@ -0,0 +1,12 @@
+{
+  "name": "<%= @app %>",
+  "main": "site.js",
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "dependencies": {<%= if @css == "tailwind-bun" do %>
+    "tailwindcss": "^4.1.0",
+    "@tailwindcss/cli": "^4.1.0",
+    "@tailwindcss/typography": "^0.5.16"<% end %>
+  }
+}
diff --git a/priv/templates/eex/lib/layouts/root_layout.ex b/priv/templates/eex/lib/layouts/root_layout.ex
index 19d5a92..99398cf 100644
--- a/priv/templates/eex/lib/layouts/root_layout.ex
+++ b/priv/templates/eex/lib/layouts/root_layout.ex
@@ -13,13 +13,14 @@ defmodule <%= @app_module %>.RootLayout do
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 
         <title>
-          <%%= [@page[:title], <%= @app_module %>]
+          <%%= [@page[:title], "<%= @app %>"]
               |> Enum.filter(& &1)
               |> Enum.intersperse("|")
               |> Enum.join(" ") %>
         </title>
 
         <link rel="stylesheet" href="/css/site.css" />
+        <script src="/js/site.js"></script>
       </head>
 
       <body>
diff --git a/priv/templates/esbuild/assets/js/site.js b/priv/templates/esbuild/assets/js/site.js
new file mode 100644
index 0000000..e69de29
diff --git a/priv/templates/heex/lib/layouts/root_layout.ex b/priv/templates/heex/lib/layouts/root_layout.ex
index 82a5c8a..c5e3d42 100644
--- a/priv/templates/heex/lib/layouts/root_layout.ex
+++ b/priv/templates/heex/lib/layouts/root_layout.ex
@@ -13,13 +13,14 @@ defmodule <%= @app_module %>.RootLayout do
         <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 
         <title>
-          <%%= [@page[:title], <%= @app_module %>]
+          <%%= [@page[:title], "<%= @app %>"]
               |> Enum.filter(& &1)
               |> Enum.intersperse("|")
               |> Enum.join(" ") %>
         </title>
 
         <link rel="stylesheet" href="/css/site.css" />
+        <script src="/js/site.js" />
       </head>
 
       <body>
diff --git a/priv/templates/no_assets/extra/js/site.js b/priv/templates/no_assets/extra/js/site.js
new file mode 100644
index 0000000..e69de29
diff --git a/priv/templates/primary/config/config.exs b/priv/templates/primary/config/config.exs
index a0621e2..a11823a 100644
--- a/priv/templates/primary/config/config.exs
+++ b/priv/templates/primary/config/config.exs
@@ -3,7 +3,7 @@ import Config
 config :tableau, :reloader,
   patterns: [
     ~r"^lib/.*.ex",
-    ~r"^(_posts|_pages)/.*.md",<%= if @assets == "tailwind" do %>
+    ~r"^(_posts|_pages)/.*.md",<%= if @css == "tailwind" or @js == "esbuild" do %>
     ~r"^assets/.*.(css|js)"<% else %>~r"^extra/.*.(css|js)"<% end %>
   ]
 
@@ -15,9 +15,15 @@ config :web_dev_utils, :reload_log, true
 config :temple,
   engine: EEx.SmartEngine,
   attributes: {Temple, :attributes}
-<% end %>
-
-<%= if @assets == "tailwind" do %>
+<% end %><%= if @js == "esbuild" do %>
+config :esbuild,
+  version: "0.25.5",
+  default: [
+    args: ~w(js/site.js --bundle --target=es2016 --outdir=../_site/js),
+    cd: Path.expand("../assets", __DIR__),
+    env: %{"NODE_PATH" => Path.expand("../deps", __DIR__)}
+  ]
+<% end %><%= if @css == "tailwind" do %>
 config :tailwind,
   version: "4.1.0",
   default: [
@@ -26,9 +32,32 @@ config :tailwind,
     --output=_site/css/site.css
     )
   ]
-
-config :tableau, :assets, tailwind: {Tailwind, :install_and_run, [:default, ~w(--watch)]}
-<% end %>
+<% end %><%= if @js == "bun" do %>
+config :bun,
+  version: "1.2.4",
+  install: [
+    args: ~w(install)
+  ],
+  default: [
+    args: ~w(
+    build 
+    assets/js/site.js  
+    --outdir=_site/js
+    )
+  ]<% end %><%= if @css == "tailwind-bun" do %>,
+  css: [
+    args: ~w(
+    run tailwindcss
+    --input=assets/css/site.css
+    --output=_site/css/site.css
+    )
+  ]<% end %>
+config :tableau, :assets, [<%= if @css == "tailwind" do %>
+  tailwind: {Tailwind, :install_and_run, [:default, ~w(--watch)]},<% end %><%= if @js == "esbuild" do %>
+  esbuild: {Esbuild, :install_and_run, [:default, ~w(--watch)]},<% end %><%= if @js == "bun" do %>
+  bun: {Bun, :install_and_run, [:default, ~w(--watch)]},<% end %><%= if @css == "tailwind-bun" do %>
+  tailwind: {Bun, :install_and_run, [:css, ~w(--watch)]},<% end %>
+]
 
 config :tableau, :config,
   url: "http://localhost:4999",
diff --git a/priv/templates/primary/gitignore b/priv/templates/primary/gitignore
index 9502c16..11dfff7 100644
--- a/priv/templates/primary/gitignore
+++ b/priv/templates/primary/gitignore
@@ -20,7 +20,11 @@ erl_crash.dump
 *.ez
 
 # Ignore package tarball (built via "mix hex.build").
-tableau_new-*.tar
+<%= @app %>-*.tar
+
+/_site/
+
+/node_modules/
 
 # Temporary files, for example, from tests.
 /tmp/
diff --git a/priv/templates/primary/mix.exs b/priv/templates/primary/mix.exs
index fb883bf..61db072 100644
--- a/priv/templates/primary/mix.exs
+++ b/priv/templates/primary/mix.exs
@@ -23,10 +23,12 @@ defmodule <%= @app_module %>.MixProject do
   # Run "mix help deps" to learn about dependencies.
   defp deps do
     [
-      {:tableau, "~> 0.25"}<%= if @assets == "tailwind" do %>,
+      {:tableau, "~> 0.26"}<%= if @css == "tailwind" do %>,
       {:tailwind, "~> 0.3", runtime: Mix.env() == :dev}<% end %><%= if @template == "temple" do %>,
       {:temple, "~> 0.12"}<% end %><%= if @template == "heex" do %>,
-      {:phoenix_live_view, "~> 1.0"}<% end %>
+      {:phoenix_live_view, "~> 1.0"}<% end %><%= if @js == "esbuild" do %>,
+      {:esbuild, "~> 0.10", runtime: Mix.env() == :dev}<% end %><%= if @js == "bun" do %>,
+      {:bun, "~> 1.5", runtime: Mix.env() == :dev}<% end %>
 
       # {:dep_from_hexpm, "~> 0.3.0"},
       # {:dep_from_git, git: "https://github.com/elixir-lang/my_dep.git", tag: "0.1.0"}
@@ -35,7 +37,7 @@ defmodule <%= @app_module %>.MixProject do
 
   defp aliases do
     [
-      build: ["tableau.build"<%= if @assets == "tailwind" do %>, "tailwind default --minify"<% end %>]
+      build: ["tableau.build"<%= if @css == "tailwind" do %>, "tailwind default --minify"<% end %><%= if @js == "esbuild" do %>, "esbuild default --minify"<% end %>]
     ]
   end
 end
diff --git a/priv/templates/temple/lib/layouts/root_layout.ex b/priv/templates/temple/lib/layouts/root_layout.ex
index 8ad58e8..c1b1bdc 100644
--- a/priv/templates/temple/lib/layouts/root_layout.ex
+++ b/priv/templates/temple/lib/layouts/root_layout.ex
@@ -13,13 +13,14 @@ defmodule <%= @app_module %>.RootLayout do
           meta name: "viewport", content: "width=device-width, initial-scale=1.0"
 
           title do
-            [@page[:title], <%= Macro.to_string(@app_module) %>]
+            [@page[:title], <%= @app %>]
             |> Enum.filter(& &1)
             |> Enum.intersperse("|")
             |> Enum.join(" ")
           end
 
           link rel: "stylesheet", href: "/css/site.css"
+          script src: "/js/site.js"
         end
 
         body do

From b37b4feaf305a1c55d7617d7b4ec4662a544ce32 Mon Sep 17 00:00:00 2001
From: Mitchell Hanberg <mitch@mitchellhanberg.com>
Date: Mon, 7 Jul 2025 16:01:46 -0400
Subject: [PATCH 2/3] fixup! feat!: bun, esbuild

---
 lib/mix/tasks/tableau.new.ex | 66 ++++++++++--------------------------
 1 file changed, 18 insertions(+), 48 deletions(-)

diff --git a/lib/mix/tasks/tableau.new.ex b/lib/mix/tasks/tableau.new.ex
index 0404a1f..9cee47a 100644
--- a/lib/mix/tasks/tableau.new.ex
+++ b/lib/mix/tasks/tableau.new.ex
@@ -113,32 +113,17 @@ defmodule Mix.Tasks.Tableau.New do
     case opts[:template] do
       "temple" ->
         for source <- Path.wildcard(Path.join(templates, "temple/**/*.{ex,exs}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "temple"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "temple", app, assigns)
         end
 
       "heex" ->
         for source <- Path.wildcard(Path.join(templates, "heex/**/*.{ex,exs}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "heex"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "heex", app, assigns)
         end
 
       template when template in ["eex", nil] ->
         for source <- Path.wildcard(Path.join(templates, "eex/**/*.{ex,exs}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "eex"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "eex", app, assigns)
         end
 
       value ->
@@ -154,32 +139,17 @@ defmodule Mix.Tasks.Tableau.New do
     case opts[:js] do
       "esbuild" ->
         for source <- Path.wildcard(Path.join(templates, "esbuild/**/*.{css,js}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "esbuild"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "esbuild", app, assigns)
         end
 
       "bun" ->
         for source <- Path.wildcard(Path.join(templates, "bun/**/*.{css,js,json}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "bun"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "bun", app, assigns)
         end
 
       js when js in ["vanilla", nil] ->
         for source <- Path.wildcard(Path.join(templates, "no_assets/**/*.{js}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "no_assets"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "no_assets", app, assigns)
         end
 
       js ->
@@ -195,22 +165,12 @@ defmodule Mix.Tasks.Tableau.New do
     case opts[:css] do
       "tailwind" ->
         for source <- Path.wildcard(Path.join(templates, "tailwind/**/*.{css,js}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "tailwind"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "tailwind", app, assigns)
         end
 
       css when css in ["vanilla", nil] ->
         for source <- Path.wildcard(Path.join(templates, "no_assets/**/*.{css}")) do
-          target =
-            source
-            |> Path.relative_to(Path.join(templates, "no_assets"))
-            |> String.replace("app_name", app)
-
-          Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+          copy_templates(source, templates, "no_assets", app, assigns)
         end
 
       css ->
@@ -238,4 +198,14 @@ defmodule Mix.Tasks.Tableau.New do
     mix tableau.server
     """)
   end
+
+  defp copy_templates(source, templates, app, kind, assigns) do
+    target =
+      source
+      |> Path.relative_to(Path.join(templates, kind))
+      |> String.replace("app_name", app)
+      |> then(&Path.join(app, &1))
+
+    Mix.Generator.copy_template(source, target, assigns)
+  end
 end

From c314de06925fb4ea4b996afa6726944098d2efe3 Mon Sep 17 00:00:00 2001
From: Mitchell Hanberg <mitch@mitchellhanberg.com>
Date: Mon, 7 Jul 2025 16:02:59 -0400
Subject: [PATCH 3/3] fixup! feat!: bun, esbuild

---
 lib/mix/tasks/tableau.new.ex | 7 +------
 1 file changed, 1 insertion(+), 6 deletions(-)

diff --git a/lib/mix/tasks/tableau.new.ex b/lib/mix/tasks/tableau.new.ex
index 9cee47a..5b70e7f 100644
--- a/lib/mix/tasks/tableau.new.ex
+++ b/lib/mix/tasks/tableau.new.ex
@@ -102,12 +102,7 @@ defmodule Mix.Tasks.Tableau.New do
     Mix.Generator.create_file(Path.join(app, "extra/.keep"), "")
 
     for source <- Path.wildcard(Path.join(templates, "primary/**/*.{ex,exs}")) do
-      target =
-        source
-        |> Path.relative_to(Path.join(templates, "primary"))
-        |> String.replace("app_name", app)
-
-      Mix.Generator.copy_template(source, Path.join(app, target), assigns)
+      copy_templates(source, templates, "primary", app, assigns)
     end
 
     case opts[:template] do