voidable-hotwire 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '029e2a1953a40d0450185108452061a44fc481aa8aaae0c7b28782e08ca7fc09'
-  data.tar.gz: 259637c4581390e625f31bc5308e108a7fc133b28a28f46eff1905efcea65a10
+  metadata.gz: 9abae5966616acf1bb8a037ed7eaae7433e5a0c8ac72b47896739281ba0ecd10
+  data.tar.gz: 8d570608eeb27e61ffb72429b258040fc7b9a5855457208693541a5312ae34e7
 SHA512:
-  metadata.gz: 5515541709822ddda8bb0b297f3a54b1fd4d2be122228db8f01c73abff7025b596e4e734f16b7fbea8eb51b43f7c3e87b45be43981658558fff0d5ba8a1e74c1
-  data.tar.gz: dce17dfbbfa35cbddefe72c203a786cd791cf8b0e15711d418b16d53d609e448360f3024a0abeb1e7884fec9198762339b70f536eedbb4fd126fe0f5ec3c9e41
+  metadata.gz: f20748f43e723982c55976bc44df0814b5267d8650074e4c3376d6eeac1a22a9898a2a90590e841e8c78878a85b4f17aae215978877a03b56f8f62133dbac2e8
+  data.tar.gz: 7e29e9da0a0736d47e230319b523a704835c56ff4df2e4d47169fb1e309a0b8235508c06747119dd8721b32d918e3d01f4d3143f47fd6b5fbd1a2641a6946967

data/app/views/devise/confirmations/new.html.erb

@@ -0,0 +1,22 @@
+<div class="devise-container">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Resend confirmation instructions</h1>
+      <p class="devise-description">Enter the email address you used to register and we'll send you a new confirmation link.</p>
+
+      <%= form_for(resource, as: resource_name, url: confirmation_path(resource_name), html: { method: :post, class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <void-field label="Email">
+          <void-input type="email" name="<%= resource_name %>[email]" value="<%= (resource.pending_reconfirmation? ? resource.unconfirmed_email : resource.email) %>" autofocus autocomplete="email" placeholder="you@example.com"></void-input>
+        </void-field>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Resend confirmation instructions</void-button>
+        </div>
+      <% end %>
+
+      <%= render "devise/shared/links" %>
+    </div>
+  </void-card>
+</div>

data/app/views/devise/passwords/edit.html.erb

@@ -0,0 +1,27 @@
+<div class="devise-container">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Change your password</h1>
+
+      <%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :put, class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <%= f.hidden_field :reset_password_token %>
+
+        <void-field label="New password" helper="6 characters minimum">
+          <void-action-input type="password" name="<%= resource_name %>[password]" icon="eye" action-label="Toggle visibility" autofocus autocomplete="new-password"></void-action-input>
+        </void-field>
+
+        <void-field label="Confirm new password">
+          <void-action-input type="password" name="<%= resource_name %>[password_confirmation]" icon="eye" action-label="Toggle visibility" autocomplete="new-password"></void-action-input>
+        </void-field>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Change my password</void-button>
+        </div>
+      <% end %>
+
+      <%= render "devise/shared/links" %>
+    </div>
+  </void-card>
+</div>

data/app/views/devise/passwords/new.html.erb

@@ -0,0 +1,21 @@
+<div class="devise-container">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Forgot your password?</h1>
+
+      <%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :post, class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <void-field label="Email">
+          <void-input type="email" name="<%= resource_name %>[email]" value="<%= resource.email %>" autofocus autocomplete="email" placeholder="you@example.com"></void-input>
+        </void-field>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Send reset instructions</void-button>
+        </div>
+      <% end %>
+
+      <%= render "devise/shared/links" %>
+    </div>
+  </void-card>
+</div>

data/app/views/devise/registrations/edit.html.erb

@@ -0,0 +1,50 @@
+<div class="devise-container devise-container--wide">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Account settings</h1>
+
+      <%= form_for(resource, as: resource_name, url: registration_path(resource_name), html: { method: :put, class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <void-field label="Email">
+          <void-input type="email" name="<%= resource_name %>[email]" value="<%= resource.email %>" autofocus autocomplete="email"></void-input>
+        </void-field>
+
+        <% if devise_mapping.confirmable? && resource.pending_reconfirmation? %>
+          <void-alert>Currently waiting confirmation for: <%= resource.unconfirmed_email %></void-alert>
+        <% end %>
+
+        <void-field label="New password" helper="Leave blank if you don't want to change it">
+          <void-action-input type="password" name="<%= resource_name %>[password]" icon="eye" action-label="Toggle visibility" autocomplete="new-password"></void-action-input>
+        </void-field>
+
+        <void-field label="Confirm new password">
+          <void-action-input type="password" name="<%= resource_name %>[password_confirmation]" icon="eye" action-label="Toggle visibility" autocomplete="new-password"></void-action-input>
+        </void-field>
+
+        <void-field label="Current password" helper="We need your current password to confirm changes">
+          <void-action-input type="password" name="<%= resource_name %>[current_password]" icon="eye" action-label="Toggle visibility" autocomplete="current-password"></void-action-input>
+        </void-field>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Update</void-button>
+        </div>
+      <% end %>
+    </div>
+  </void-card>
+
+  <div class="danger-zone">
+    <p class="devise-danger-label">Danger zone</p>
+    <void-button variant="outline" color="error" size="sm" onclick="document.getElementById('delete-dialog').open = true">Delete my account</void-button>
+  </div>
+
+  <void-dialog id="delete-dialog" heading="Delete account" size="sm">
+    <p class="danger-zone-description">
+      Are you sure you want to delete your account? This action cannot be undone.
+    </p>
+    <div class="action-bar">
+      <void-button variant="ghost" size="sm" onclick="document.getElementById('delete-dialog').open = false">Cancel</void-button>
+      <void-button color="error" size="sm"><a href="<%= registration_path(resource_name) %>" data-turbo-method="delete">Delete</a></void-button>
+    </div>
+  </void-dialog>
+</div>

data/app/views/devise/registrations/new.html.erb

@@ -0,0 +1,29 @@
+<div class="devise-container">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Sign up</h1>
+
+      <%= form_for(resource, as: resource_name, url: registration_path(resource_name), html: { class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <void-field label="Email">
+          <void-input type="email" name="<%= resource_name %>[email]" value="<%= resource.email %>" autofocus autocomplete="email" placeholder="you@example.com"></void-input>
+        </void-field>
+
+        <void-field label="Password" helper="<%= @minimum_password_length %> characters minimum">
+          <void-action-input type="password" name="<%= resource_name %>[password]" icon="eye" action-label="Toggle visibility" autocomplete="new-password" minlength="<%= @minimum_password_length %>"></void-action-input>
+        </void-field>
+
+        <void-field label="Password confirmation">
+          <void-action-input type="password" name="<%= resource_name %>[password_confirmation]" icon="eye" action-label="Toggle visibility" autocomplete="new-password"></void-action-input>
+        </void-field>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Sign up</void-button>
+        </div>
+      <% end %>
+
+      <%= render "devise/shared/links" %>
+    </div>
+  </void-card>
+</div>

data/app/views/devise/sessions/new.html.erb

@@ -0,0 +1,35 @@
+<div class="devise-container">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Sign in</h1>
+
+      <%= form_for(resource, as: resource_name, url: session_path(resource_name), html: { class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <void-field label="Email">
+          <void-input type="email" name="<%= resource_name %>[email]" value="<%= resource.email %>" autofocus autocomplete="email" placeholder="you@example.com"></void-input>
+        </void-field>
+
+        <void-field label="Password">
+          <void-action-input type="password" name="<%= resource_name %>[password]" icon="eye" action-label="Toggle visibility" autocomplete="current-password"></void-action-input>
+        </void-field>
+
+        <% if devise_mapping.rememberable? %>
+          <void-field label="Remember me">
+            <void-switch name="<%= resource_name %>[remember_me]"></void-switch>
+          </void-field>
+        <% end %>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Sign in</void-button>
+        </div>
+
+        <% if devise_mapping.recoverable? %>
+          <void-button variant="ghost" class="devise-btn-full"><a href="<%= new_password_path(resource_name) %>">Forgot your password?</a></void-button>
+        <% end %>
+      <% end %>
+
+      <%= render "devise/shared/links" %>
+    </div>
+  </void-card>
+</div>

data/app/views/devise/shared/_error_messages.html.erb

@@ -0,0 +1,10 @@
+<% if resource.errors.any? %>
+  <void-alert color="error" data-turbo-temporary>
+    <%= pluralize(resource.errors.count, "error") %> prohibited this operation:
+    <ul class="devise-error-list">
+      <% resource.errors.full_messages.each do |message| %>
+        <li><%= message %></li>
+      <% end %>
+    </ul>
+  </void-alert>
+<% end %>

data/app/views/devise/shared/_links.html.erb

@@ -0,0 +1,33 @@
+<div class="devise-divider">
+  <div class="devise-divider-line"></div>
+  <span class="devise-divider-text">or</span>
+  <div class="devise-divider-line"></div>
+</div>
+
+<div class="devise-links">
+  <%- if controller_name != 'sessions' %>
+    <void-button variant="ghost" class="devise-btn-full"><a href="<%= new_session_path(resource_name) %>">Sign in</a></void-button>
+  <% end %>
+
+  <%- if devise_mapping.registerable? && controller_name != 'registrations' %>
+    <void-button variant="ghost" color="info" class="devise-btn-full"><a href="<%= new_registration_path(resource_name) %>">Sign up</a></void-button>
+  <% end %>
+
+  <%- if devise_mapping.recoverable? && controller_name != 'passwords' && controller_name != 'registrations' && controller_name != 'sessions' %>
+    <void-button variant="ghost" class="devise-btn-full"><a href="<%= new_password_path(resource_name) %>">Forgot your password?</a></void-button>
+  <% end %>
+
+  <%- if devise_mapping.confirmable? && controller_name != 'confirmations' %>
+    <void-button variant="ghost" class="devise-btn-full"><a href="<%= new_confirmation_path(resource_name) %>">Didn't receive confirmation instructions?</a></void-button>
+  <% end %>
+
+  <%- if devise_mapping.lockable? && resource_class.unlock_strategy_enabled?(:email) && controller_name != 'unlocks' %>
+    <void-button variant="ghost" class="devise-btn-full"><a href="<%= new_unlock_path(resource_name) %>">Didn't receive unlock instructions?</a></void-button>
+  <% end %>
+
+  <%- if devise_mapping.omniauthable? %>
+    <%- resource_class.omniauth_providers.each do |provider| %>
+      <%= button_to "Sign in with #{OmniAuth::Utils.camelize(provider)}", omniauth_authorize_path(resource_name, provider), data: { turbo: false } %>
+    <% end %>
+  <% end %>
+</div>

data/app/views/devise/unlocks/new.html.erb

@@ -0,0 +1,22 @@
+<div class="devise-container">
+  <void-card>
+    <div class="devise-card-body">
+      <h1 class="devise-heading">Resend unlock instructions</h1>
+      <p class="devise-description">Enter your email address and we'll send you instructions to unlock your account.</p>
+
+      <%= form_for(resource, as: resource_name, url: unlock_path(resource_name), html: { method: :post, class: "devise-form" }) do |f| %>
+        <%= render "devise/shared/error_messages", resource: resource %>
+
+        <void-field label="Email">
+          <void-input type="email" name="<%= resource_name %>[email]" value="<%= resource.email %>" autofocus autocomplete="email" placeholder="you@example.com"></void-input>
+        </void-field>
+
+        <div class="devise-submit">
+          <void-button type="submit" color="success" class="devise-btn-full">Resend unlock instructions</void-button>
+        </div>
+      <% end %>
+
+      <%= render "devise/shared/links" %>
+    </div>
+  </void-card>
+</div>

data/lib/generators/voidable/devise_views/devise_views_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Voidable
+  module Generators
+    class DeviseViewsGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../../app/views/devise", __dir__)
+
+      desc "Copy Voidable-styled Devise views into your application"
+
+      def copy_views
+        directory ".", "app/views/devise"
+      end
+    end
+  end
+end

data/lib/generators/voidable/install/install_generator.rb

@@ -0,0 +1,112 @@
+module Voidable
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Install Voidable UI into your Rails application"
+
+      class_option :layout, type: :string, default: "topbar", enum: ["topbar", "sidebar", "switching"],
+        desc: "Application layout style (topbar, sidebar, or switching)"
+
+      def create_initializer
+        template "initializer.rb.tt", "config/initializers/voidable.rb"
+      end
+
+      def pin_packages
+        importmap = "config/importmap.rb"
+        return unless File.exist?(importmap)
+        return if File.read(importmap).include?("@voidable/ui")
+        append_to_file importmap, <<~RUBY
+
+          # Voidable UI
+          pin "@voidable/ui", to: "https://ga.jspm.io/npm:@voidable/ui@0.0.1/dist/ui.js"
+          pin "@voidable/ui-hotwire", to: "https://ga.jspm.io/npm:@voidable/ui-hotwire@0.0.1/dist/hotwire.js"
+        RUBY
+        say "Pinned @voidable/ui and @voidable/ui-hotwire in importmap", :green
+      end
+
+      def create_layout
+        copy_file "_settings_menu.html.erb", "app/views/layouts/_settings_menu.html.erb"
+
+        case options[:layout]
+        when "sidebar"
+          template "application_sidebar.html.erb.tt", "app/views/layouts/application.html.erb", force: true
+        when "switching"
+          template "application_topbar.html.erb.tt", "app/views/layouts/application.html.erb", force: true
+          template "topbar.html.erb.tt", "app/views/layouts/topbar.html.erb"
+          template "sidebar.html.erb.tt", "app/views/layouts/sidebar.html.erb"
+        else
+          template "application_topbar.html.erb.tt", "app/views/layouts/application.html.erb", force: true
+        end
+        say "Created Voidable application layout (#{options[:layout]})", :green
+      end
+
+      def create_layout_assets
+        copy_file "voidable-layout.js", "app/assets/javascripts/voidable-layout.js"
+        copy_file "voidable-devise.css", "app/assets/stylesheets/voidable-devise.css"
+
+        assets_init = "config/initializers/assets.rb"
+        if File.exist?(assets_init) && !File.read(assets_init).include?("javascripts")
+          append_to_file assets_init, <<~RUBY
+
+            # Voidable layout scripts
+            Rails.application.config.assets.paths << Rails.root.join("app/assets/javascripts")
+          RUBY
+        end
+
+        case options[:layout]
+        when "sidebar"
+          copy_file "voidable-layout-sidebar.css", "app/assets/stylesheets/voidable-layout.css", force: true
+        when "switching"
+          copy_file "voidable-layout-topbar.css", "app/assets/stylesheets/voidable-layout-topbar.css"
+          copy_file "voidable-layout-sidebar.css", "app/assets/stylesheets/voidable-layout-sidebar.css"
+        else
+          copy_file "voidable-layout-topbar.css", "app/assets/stylesheets/voidable-layout.css", force: true
+        end
+        say "Created Voidable layout assets", :green
+      end
+
+      def setup_layout_switching
+        return unless options[:layout] == "switching"
+
+        template "settings_controller.rb.tt", "app/controllers/settings_controller.rb"
+
+        route 'post "toggle_layout", to: "settings#toggle_layout"'
+
+        inject_into_class "app/controllers/application_controller.rb", "ApplicationController", <<-RUBY
+
+  layout :resolve_layout
+
+  private
+
+  def resolve_layout
+    cookies[:layout] || "topbar"
+  end
+        RUBY
+
+        say "Configured layout switching (topbar/sidebar toggle)", :green
+      end
+
+      def add_js_import
+        js_entrypoint = "app/javascript/application.js"
+        return unless File.exist?(js_entrypoint)
+        return if File.read(js_entrypoint).include?("@voidable/ui")
+        prepend_to_file js_entrypoint, "import \"@voidable/ui\";\nimport \"@voidable/ui-hotwire\";\n\n"
+        say "Added Voidable imports to application.js", :green
+      end
+
+      private
+
+      def app_name
+        Rails.application.class.module_parent_name.underscore
+      end
+
+      public
+
+      def install_devise_views
+        return unless defined?(Devise)
+        generate "voidable:devise_views"
+        say "Installed Voidable-styled Devise views", :green
+      end
+    end
+  end
+end

data/lib/generators/voidable/install/templates/_settings_menu.html.erb

@@ -0,0 +1,31 @@
+<void-popover position="<%= local_assigns[:popover_position] || 'top' %>" id="settings-popover">
+  <button class="settings-btn" aria-label="View Settings" title="View Settings">
+    <i class="ti ti-settings"></i>
+  </button>
+  <div class="settings-menu">
+    <% if defined?(Devise) && user_signed_in? %>
+      <div class="settings-menu-item">
+        <a href="<%= edit_user_registration_path %>" class="settings-menu-action">
+          <i class="ti ti-user"></i>
+          Profile
+        </a>
+      </div>
+    <% end %>
+    <label class="settings-menu-item">
+      <i class="ti ti-moon"></i>
+      <span>Dark mode</span>
+      <void-switch id="theme-toggle" size="sm" aria-label="Toggle theme"></void-switch>
+    </label>
+    <% if local_assigns[:layout_toggle] %>
+      <div class="settings-menu-item">
+        <form action="/toggle_layout" method="post" class="settings-menu-form">
+          <input type="hidden" name="authenticity_token" value="<%= form_authenticity_token %>">
+          <button type="submit" class="settings-menu-action">
+            <i class="ti ti-<%= local_assigns[:layout_toggle_icon] %>"></i>
+            <%= local_assigns[:layout_toggle_label] %>
+          </button>
+        </form>
+      </div>
+    <% end %>
+  </div>
+</void-popover>

data/lib/generators/voidable/install/templates/application_sidebar.html.erb.tt

@@ -0,0 +1,86 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><%%= content_for(:title) || "<%= app_name.titleize %>" %></title>
+    <%%= csrf_meta_tags %>
+    <%%= csp_meta_tag %>
+    <%%= yield :head %>
+    <%%= stylesheet_link_tag :app, "data-turbo-track": "reload" %>
+    <%%= stylesheet_link_tag "voidable-theme", "data-turbo-track": "reload" %>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@3.44.0/dist/tabler-icons.min.css">
+    <%%= stylesheet_link_tag "voidable-layout", "data-turbo-track": "reload" %>
+    <%%= stylesheet_link_tag "voidable-devise", "data-turbo-track": "reload" %>
+    <%%= javascript_importmap_tags %>
+  </head>
+
+  <body>
+    <div class="app-shell">
+      <void-sidebar width="220px">
+        <div class="sidebar-header">
+          <div class="sidebar-brand-initial"><%= app_name.first.upcase %></div>
+          <div class="sidebar-brand-info">
+            <div class="sidebar-brand-name"><%= app_name.titleize %></div>
+            <div class="sidebar-brand-env">Production</div>
+          </div>
+        </div>
+
+        <nav class="sidebar-nav">
+          <div class="sidebar-nav-section">
+            <div class="sidebar-nav-label">Main</div>
+            <div class="sidebar-nav-item">
+              <%%= link_to "Dashboard", root_path %>
+            </div>
+          </div>
+
+        </nav>
+
+        <div class="sidebar-footer">
+          <div class="sidebar-footer-row">
+            <%% if defined?(Devise) && user_signed_in? %>
+              <span class="sidebar-user-email"><%%= current_user.email %></span>
+            <%% end %>
+            <%%= render "layouts/settings_menu", popover_position: "top" %>
+          </div>
+          <%% if defined?(Devise) && user_signed_in? %>
+            <void-button variant="ghost" size="sm" class="sidebar-sign-in"><a href="<%%= destroy_user_session_path %>" data-turbo-method="delete">Sign out</a></void-button>
+          <%% elsif defined?(Devise) %>
+            <void-button variant="ghost" size="sm" class="sidebar-sign-in"><a href="<%%= new_user_session_path %>">Sign in</a></void-button>
+          <%% end %>
+        </div>
+      </void-sidebar>
+
+      <main class="app-main">
+        <div class="app-content-header">
+          <div class="app-content-header-left">
+            <span class="app-content-header-breadcrumb"><%%= content_for(:breadcrumb) || content_for(:title) || "<%= app_name.titleize %>" %></span>
+            <%% if content_for?(:subtitle) %>
+              <span class="app-content-header-subtitle"><%%= content_for(:subtitle) %></span>
+            <%% end %>
+          </div>
+          <div class="app-content-header-right">
+            <void-action-input icon="search" placeholder="Search…" size="sm" tooltip-position="bottom" class="app-content-header-search"></void-action-input>
+            <%%= content_for(:header_actions) %>
+          </div>
+        </div>
+        <div class="app-content-body">
+          <%% if notice.present? %>
+            <div class="flash-messages">
+              <void-alert color="success" dismissible><%%= notice %></void-alert>
+            </div>
+          <%% end %>
+          <%% if alert.present? %>
+            <div class="flash-messages">
+              <void-alert color="error" dismissible><%%= alert %></void-alert>
+            </div>
+          <%% end %>
+
+          <%%= yield %>
+        </div>
+      </main>
+    </div>
+
+    <%%= javascript_include_tag "voidable-layout", "data-turbo-track": "reload" %>
+  </body>
+</html>

data/lib/generators/voidable/install/templates/application_topbar.html.erb.tt

@@ -0,0 +1,69 @@
+<!DOCTYPE html>
+<html lang="en" data-theme="dark">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><%%= content_for(:title) || "<%= app_name.titleize %>" %></title>
+    <%%= csrf_meta_tags %>
+    <%%= csp_meta_tag %>
+    <%%= yield :head %>
+    <%%= stylesheet_link_tag :app, "data-turbo-track": "reload" %>
+    <%%= stylesheet_link_tag "voidable-theme", "data-turbo-track": "reload" %>
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@tabler/icons-webfont@3.44.0/dist/tabler-icons.min.css">
+    <%%= stylesheet_link_tag "voidable-layout", "data-turbo-track": "reload" %>
+    <%%= stylesheet_link_tag "voidable-devise", "data-turbo-track": "reload" %>
+    <%%= javascript_importmap_tags %>
+  </head>
+
+  <body>
+    <nav class="app-nav">
+      <div class="app-nav-inner">
+        <a href="/" class="app-nav-brand"><%= app_name.titleize %></a>
+        <div class="app-nav-right">
+          <span class="app-nav-auth">
+            <%% if defined?(Devise) && user_signed_in? %>
+              <span><%%= current_user.email %></span>
+            <%% elsif defined?(Devise) %>
+              <a href="<%%= new_user_session_path %>">Sign in</a>
+            <%% end %>
+          </span>
+          <%%= render "layouts/settings_menu", popover_position: "bottom" %>
+          <%% if defined?(Devise) && user_signed_in? %>
+            <void-button variant="ghost" size="sm"><a href="<%%= destroy_user_session_path %>" data-turbo-method="delete">Sign out</a></void-button>
+          <%% end %>
+        </div>
+      </div>
+    </nav>
+
+    <main class="app-main">
+      <div class="app-content-header">
+        <div class="app-content-header-left">
+          <span class="app-content-header-breadcrumb"><%%= content_for(:breadcrumb) || content_for(:title) || "<%= app_name.titleize %>" %></span>
+          <%% if content_for?(:subtitle) %>
+            <span class="app-content-header-subtitle"><%%= content_for(:subtitle) %></span>
+          <%% end %>
+        </div>
+        <div class="app-content-header-right">
+          <void-action-input icon="search" placeholder="Search..." size="sm" tooltip-position="bottom" class="app-content-header-search"></void-action-input>
+          <%%= content_for(:header_actions) %>
+        </div>
+      </div>
+      <div class="app-content-body">
+        <%% if notice.present? %>
+          <div class="flash-messages">
+            <void-alert color="success" dismissible><%%= notice %></void-alert>
+          </div>
+        <%% end %>
+        <%% if alert.present? %>
+          <div class="flash-messages">
+            <void-alert color="error" dismissible><%%= alert %></void-alert>
+          </div>
+        <%% end %>
+
+        <%%= yield %>
+      </div>
+    </main>
+
+    <%%= javascript_include_tag "voidable-layout", "data-turbo-track": "reload" %>
+  </body>
+</html>

data/lib/generators/voidable/install/templates/initializer.rb.tt

@@ -0,0 +1,2 @@
+# Voidable UI configuration
+# See https://voidable.dev for documentation

data/lib/generators/voidable/install/templates/settings_controller.rb.tt

@@ -0,0 +1,7 @@
+class SettingsController < ApplicationController
+  def toggle_layout
+    current = cookies[:layout] || "topbar"
+    cookies[:layout] = current == "sidebar" ? "topbar" : "sidebar"
+    redirect_back(fallback_location: root_path)
+  end
+end