jquard 0.0.1 → 0.2.0

data/app/controllers/jquard/resources_controller.rb

@@ -0,0 +1,93 @@
+module Jquard
+  class ResourcesController < ApplicationController
+    before_action :set_resource, except: :root
+    before_action :set_record, only: [ :edit, :update, :destroy ]
+
+    def root
+      first = Jquard.registry.resources.min_by { |resource| [ resource.navigation_sort, resource.navigation_label ] }
+
+      if first
+        redirect_to resource_path(first.slug)
+      else
+        render plain: "No Jquard resources registered. Run `bin/rails generate jquard:resource YourModel`."
+      end
+    end
+
+    def index
+      @page = @resource.page_for(:index)
+      @table = @resource.build_table
+      @query_params = params.permit(:q, :sort, :direction, :page, :per_page)
+      @result = Jquard::Tables::Query.new(
+        table: @table,
+        scope: @resource.model.all,
+        params: @query_params
+      ).result
+    end
+
+    def new
+      @page = @resource.page_for(:create)
+      @form_schema = @resource.build_form
+      @record = @resource.model.new
+      @form_schema.apply_defaults(@record)
+    end
+
+    def create
+      @page = @resource.page_for(:create)
+      @form_schema = @resource.build_form
+
+      data = @page.mutate_form_data_before_create(record_params.to_h)
+      @record = @page.handle_record_creation(@resource.model, data)
+
+      if @record.persisted?
+        @page.after_create(@record)
+        redirect_to @page.redirect_url_after_create(@record) || edit_resource_path(@resource.slug, @record.id),
+          notice: @page.created_notification_message
+      else
+        render :new, status: :unprocessable_entity
+      end
+    end
+
+    def edit
+      @page = @resource.page_for(:edit)
+      @form_schema = @resource.build_form
+    end
+
+    def update
+      @page = @resource.page_for(:edit)
+      @form_schema = @resource.build_form
+
+      data = @page.mutate_form_data_before_save(record_params.to_h)
+
+      if @page.handle_record_update(@record, data)
+        @page.after_save(@record)
+        redirect_to @page.redirect_url_after_save(@record) || edit_resource_path(@resource.slug, @record.id),
+          notice: @page.saved_notification_message
+      else
+        render :edit, status: :unprocessable_entity
+      end
+    end
+
+    def destroy
+      @record.destroy
+      redirect_to resource_path(@resource.slug), notice: "#{@resource.singular_label} deleted"
+    end
+
+    private
+
+    def set_resource
+      @resource = Jquard.registry.fetch(params[:resource_slug]) do
+        raise ActionController::RoutingError,
+          "No Jquard resource registered for #{params[:resource_slug].inspect}"
+      end
+    end
+
+    def set_record
+      @record = @resource.model.find(params[:record_id])
+    end
+
+    def record_params
+      params.require(@resource.model.model_name.param_key)
+            .permit(*@resource.build_form.field_names)
+    end
+  end
+end

data/app/helpers/jquard/application_helper.rb

@@ -1,4 +1,50 @@
 module Jquard
   module ApplicationHelper
+    def jquard_navigation
+      Jquard.registry.resources
+        .sort_by { |resource| [ resource.navigation_sort, resource.navigation_label ] }
+        .group_by(&:navigation_group)
+        .sort_by { |group, _| [ group.nil? ? 0 : 1, group.to_s ] }
+    end
+
+    def jquard_icon(name, css_class: nil)
+      Jquard::Icons.render(name, css_class: css_class).html_safe
+    end
+
+    def jquard_theme_style
+      variables = Jquard.config.primary_color_palette
+        .map { |shade, value| "--jq-primary-#{shade}: #{value};" }
+        .join(" ")
+
+      tag.style(":root { #{variables} }".html_safe)
+    end
+
+    def jquard_current_user
+      method = Jquard.config.current_user_method
+      return unless method && controller.respond_to?(method)
+
+      controller.send(method)
+    end
+
+    def jquard_user_name(user)
+      user.try(:name).presence || user.try(:email).presence || user.to_s
+    end
+
+    def jquard_user_initials(user)
+      name = jquard_user_name(user).to_s
+      name = name.split("@").first.to_s if name.include?("@")
+      name.split(/[\s._-]+/).filter_map { |part| part[0] }.join[0, 2].to_s.upcase
+    end
+
+    def jquard_sign_out_path
+      path = Jquard.config.sign_out_path
+      return instance_exec(&path) if path.respond_to?(:call)
+
+      path.presence
+    end
+
+    def jquard_sign_out_method
+      Jquard.config.sign_out_method || :delete
+    end
   end
 end

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

@@ -0,0 +1,14 @@
+<% content_for :heading, "Resend confirmation instructions" %>
+
+<%= form_for(resource, as: resource_name, url: confirmation_path(resource_name), html: { method: :post, class: "jq-auth-form" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+
+  <div class="jq-field">
+    <%= f.label :email, "Email address", class: "jq-label" %>
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", value: (resource.pending_reconfirmation? ? resource.unconfirmed_email : resource.email), class: "jq-input" %>
+  </div>
+
+  <%= f.submit "Resend confirmation instructions", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>
+
+<%= render "devise/shared/links" %>

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

@@ -0,0 +1,21 @@
+<% content_for :heading, "Reset your password" %>
+
+<%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :put, class: "jq-auth-form" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+  <%= f.hidden_field :reset_password_token %>
+
+  <div class="jq-field">
+    <%= f.label :password, class: "jq-label" %>
+    <%= f.password_field :password, autofocus: true, autocomplete: "new-password", class: "jq-input" %>
+    <% if @minimum_password_length %>
+      <p class="jq-helper-text"><%= @minimum_password_length %> characters minimum</p>
+    <% end %>
+  </div>
+
+  <div class="jq-field">
+    <%= f.label :password_confirmation, "Confirm password", class: "jq-label" %>
+    <%= f.password_field :password_confirmation, autocomplete: "new-password", class: "jq-input" %>
+  </div>
+
+  <%= f.submit "Reset password", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>

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

@@ -0,0 +1,16 @@
+<% content_for :heading, "Forgot password?" %>
+
+<% content_for :subheading do %>
+  or <%= link_to "back to login", new_session_path(resource_name), class: "jq-link" %>
+<% end %>
+
+<%= form_for(resource, as: resource_name, url: password_path(resource_name), html: { method: :post, class: "jq-auth-form" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+
+  <div class="jq-field">
+    <%= f.label :email, "Email address", class: "jq-label" %>
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", class: "jq-input" %>
+  </div>
+
+  <%= f.submit "Send email", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>

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

@@ -0,0 +1,45 @@
+<% content_for :heading, "Edit #{resource_name.to_s.humanize.downcase}" %>
+
+<%= form_for(resource, as: resource_name, url: registration_path(resource_name), html: { method: :put, class: "jq-auth-form" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+
+  <div class="jq-field">
+    <%= f.label :email, "Email address", class: "jq-label" %>
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", class: "jq-input" %>
+    <% if devise_mapping.confirmable? && resource.pending_reconfirmation? %>
+      <p class="jq-helper-text">Currently waiting confirmation for: <%= resource.unconfirmed_email %></p>
+    <% end %>
+  </div>
+
+  <div class="jq-field">
+    <%= f.label :password, class: "jq-label" %>
+    <%= f.password_field :password, autocomplete: "new-password", class: "jq-input" %>
+    <p class="jq-helper-text">
+      Leave blank if you don't want to change it<% if @minimum_password_length %> — <%= @minimum_password_length %> characters minimum<% end %>
+    </p>
+  </div>
+
+  <div class="jq-field">
+    <%= f.label :password_confirmation, "Confirm password", class: "jq-label" %>
+    <%= f.password_field :password_confirmation, autocomplete: "new-password", class: "jq-input" %>
+  </div>
+
+  <div class="jq-field">
+    <%= f.label :current_password, class: "jq-label" %>
+    <%= f.password_field :current_password, autocomplete: "current-password", class: "jq-input" %>
+    <p class="jq-helper-text">We need your current password to confirm your changes</p>
+  </div>
+
+  <%= f.submit "Update", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>
+
+<div class="jq-auth-divider"></div>
+
+<h2 class="jq-auth-heading">Cancel my account</h2>
+
+<%# The auth layout loads no JS, so data-turbo-confirm would silently not confirm. %>
+<%= button_to "Cancel my account", registration_path(resource_name), method: :delete, form: { onsubmit: "return confirm('Are you sure?')" }, class: "jq-btn jq-btn--danger jq-btn--block" %>
+
+<div class="jq-auth-links">
+  <%= link_to "Back", :back, class: "jq-link" %>
+</div>

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

@@ -0,0 +1,29 @@
+<% content_for :heading, "Sign up" %>
+
+<% content_for :subheading do %>
+  or <%= link_to "sign in to your account", new_session_path(resource_name), class: "jq-link" %>
+<% end %>
+
+<%= form_for(resource, as: resource_name, url: registration_path(resource_name), html: { class: "jq-auth-form" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+
+  <div class="jq-field">
+    <%= f.label :email, "Email address", class: "jq-label" %>
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", class: "jq-input" %>
+  </div>
+
+  <div class="jq-field">
+    <%= f.label :password, class: "jq-label" %>
+    <%= f.password_field :password, autocomplete: "new-password", class: "jq-input" %>
+    <% if @minimum_password_length %>
+      <p class="jq-helper-text"><%= @minimum_password_length %> characters minimum</p>
+    <% end %>
+  </div>
+
+  <div class="jq-field">
+    <%= f.label :password_confirmation, "Confirm password", class: "jq-label" %>
+    <%= f.password_field :password_confirmation, autocomplete: "new-password", class: "jq-input" %>
+  </div>
+
+  <%= f.submit "Sign up", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>

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

@@ -0,0 +1,33 @@
+<% content_for :heading, "Sign in" %>
+
+<% if devise_mapping.registerable? %>
+  <% content_for :subheading do %>
+    or <%= link_to "sign up for an account", new_registration_path(resource_name), class: "jq-link" %>
+  <% end %>
+<% end %>
+
+<%= form_for(resource, as: resource_name, url: session_path(resource_name), html: { class: "jq-auth-form" }) do |f| %>
+  <div class="jq-field">
+    <%= f.label :email, "Email address", class: "jq-label" %>
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", class: "jq-input" %>
+  </div>
+
+  <div class="jq-field">
+    <div class="jq-label-row">
+      <%= f.label :password, class: "jq-label" %>
+      <% if devise_mapping.recoverable? %>
+        <%= link_to "Forgot password?", new_password_path(resource_name), class: "jq-link", tabindex: -1 %>
+      <% end %>
+    </div>
+    <%= f.password_field :password, autocomplete: "current-password", class: "jq-input" %>
+  </div>
+
+  <% if devise_mapping.rememberable? %>
+    <div class="jq-field-inline">
+      <%= f.check_box :remember_me, class: "jq-checkbox" %>
+      <%= f.label :remember_me, class: "jq-label" %>
+    </div>
+  <% end %>
+
+  <%= f.submit "Sign in", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>

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

@@ -0,0 +1,15 @@
+<% if resource.errors.any? %>
+  <div id="error_explanation" class="jq-auth-errors" data-turbo-temporary>
+    <p class="jq-auth-errors-title">
+      <%= I18n.t("errors.messages.not_saved",
+                 count: resource.errors.count,
+                 resource: resource.class.model_name.human.downcase)
+       %>
+    </p>
+    <ul class="jq-auth-errors-list">
+      <% resource.errors.full_messages.each do |message| %>
+        <li><%= message %></li>
+      <% end %>
+    </ul>
+  </div>
+<% end %>

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

@@ -0,0 +1,27 @@
+<div class="jq-auth-links">
+  <%- if controller_name != 'sessions' %>
+    <%= link_to "Log in", new_session_path(resource_name), class: "jq-link" %>
+  <% end %>
+
+  <%- if devise_mapping.registerable? && controller_name != 'registrations' %>
+    <%= link_to "Sign up", new_registration_path(resource_name), class: "jq-link" %>
+  <% end %>
+
+  <%- if devise_mapping.recoverable? && controller_name != 'passwords' && controller_name != 'registrations' %>
+    <%= link_to "Forgot your password?", new_password_path(resource_name), class: "jq-link" %>
+  <% end %>
+
+  <%- if devise_mapping.confirmable? && controller_name != 'confirmations' %>
+    <%= link_to "Didn't receive confirmation instructions?", new_confirmation_path(resource_name), class: "jq-link" %>
+  <% end %>
+
+  <%- if devise_mapping.lockable? && resource_class.unlock_strategy_enabled?(:email) && controller_name != 'unlocks' %>
+    <%= link_to "Didn't receive unlock instructions?", new_unlock_path(resource_name), class: "jq-link" %>
+  <% 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 }, class: "jq-btn jq-btn--secondary jq-btn--block" %>
+    <% end %>
+  <% end %>
+</div>

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

@@ -0,0 +1,14 @@
+<% content_for :heading, "Resend unlock instructions" %>
+
+<%= form_for(resource, as: resource_name, url: unlock_path(resource_name), html: { method: :post, class: "jq-auth-form" }) do |f| %>
+  <%= render "devise/shared/error_messages", resource: resource %>
+
+  <div class="jq-field">
+    <%= f.label :email, "Email address", class: "jq-label" %>
+    <%= f.email_field :email, autofocus: true, autocomplete: "email", class: "jq-input" %>
+  </div>
+
+  <%= f.submit "Resend unlock instructions", class: "jq-btn jq-btn--primary jq-btn--block" %>
+<% end %>
+
+<%= render "devise/shared/links" %>

data/app/views/jquard/_breadcrumbs.html.erb

@@ -0,0 +1,17 @@
+<nav class="jq-breadcrumbs">
+  <ol class="jq-breadcrumbs-list">
+    <% crumbs.each_with_index do |(label, url), index| %>
+      <li class="jq-breadcrumbs-item">
+        <% unless index.zero? %>
+          <%= jquard_icon("solid/chevron-right", css_class: "jq-breadcrumbs-item-separator") %>
+        <% end %>
+
+        <% if url %>
+          <%= link_to label, url %>
+        <% else %>
+          <span><%= label %></span>
+        <% end %>
+      </li>
+    <% end %>
+  </ol>
+</nav>

data/app/views/jquard/_user_menu.html.erb

@@ -0,0 +1,23 @@
+<% if (user = jquard_current_user) %>
+  <details class="jq-dropdown jq-user-menu">
+    <summary class="jq-dropdown-trigger" aria-label="Open user menu">
+      <span class="jq-avatar"><%= jquard_user_initials(user) %></span>
+    </summary>
+
+    <div class="jq-dropdown-panel">
+      <div class="jq-dropdown-header">
+        <%= jquard_icon("user-circle", css_class: "jq-dropdown-icon") %>
+        <span class="jq-dropdown-header-label"><%= jquard_user_name(user) %></span>
+      </div>
+
+      <% if (sign_out_path = jquard_sign_out_path) %>
+        <div class="jq-dropdown-list">
+          <%= button_to sign_out_path, method: jquard_sign_out_method, form_class: "jq-dropdown-form", class: "jq-dropdown-list-item" do %>
+            <%= jquard_icon("arrow-left-end-on-rectangle", css_class: "jq-dropdown-icon") %>
+            <span class="jq-dropdown-list-item-label">Sign out</span>
+          <% end %>
+        </div>
+      <% end %>
+    </div>
+  </details>
+<% end %>

data/app/views/jquard/resources/edit.html.erb

@@ -0,0 +1,8 @@
+<header class="jq-page-header">
+  <div>
+    <%= render "jquard/breadcrumbs", crumbs: [ [ @resource.navigation_label, resource_path(@resource.slug) ], [ "Edit", nil ] ] %>
+    <h1 class="jq-page-title"><%= @page.title %></h1>
+  </div>
+</header>
+
+<%= render Jquard::Schemas::FormComponent.new(schema: @form_schema, record: @record, resource: @resource) %>

data/app/views/jquard/resources/index.html.erb

@@ -0,0 +1,22 @@
+<header class="jq-page-header">
+  <div>
+    <%= render "jquard/breadcrumbs", crumbs: [ [ @resource.navigation_label, resource_path(@resource.slug) ], [ "List", nil ] ] %>
+    <h1 class="jq-page-title"><%= @page.title %></h1>
+  </div>
+
+  <div class="jq-page-header-actions">
+    <%= link_to new_resource_path(@resource.slug), class: "jq-btn jq-btn--primary" do %>
+      <%= jquard_icon("plus", css_class: "jq-btn-icon") %>
+      <span>New <%= @resource.singular_label.downcase %></span>
+    <% end %>
+  </div>
+</header>
+
+<%= turbo_frame_tag "jquard-table", data: { turbo_action: "advance" } do %>
+  <%= render Jquard::Tables::TableComponent.new(
+        table: @table,
+        resource: @resource,
+        result: @result,
+        query_params: @query_params
+      ) %>
+<% end %>

data/app/views/jquard/resources/new.html.erb

@@ -0,0 +1,8 @@
+<header class="jq-page-header">
+  <div>
+    <%= render "jquard/breadcrumbs", crumbs: [ [ @resource.navigation_label, resource_path(@resource.slug) ], [ "Create", nil ] ] %>
+    <h1 class="jq-page-title"><%= @page.title %></h1>
+  </div>
+</header>
+
+<%= render Jquard::Schemas::FormComponent.new(schema: @form_schema, record: @record, resource: @resource) %>

data/app/views/layouts/jquard/application.html.erb

@@ -1,17 +1,79 @@
 <!DOCTYPE html>
 <html>
 <head>
-  <title>Jquard</title>
+  <title><%= Jquard.config.brand_name %></title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>
 
+  <%= jquard_theme_style %>
   <%= yield :head %>
 
-  <%= stylesheet_link_tag    "jquard/application", media: "all" %>
+  <%= stylesheet_link_tag "jquard/application", media: "all" %>
+  <%= javascript_include_tag "turbo.min", type: "module" %>
+  <%= javascript_include_tag "jquard/application", type: "module" %>
 </head>
-<body>
+<body class="jq-body">
+  <header class="jq-topbar">
+    <div class="jq-topbar-start">
+      <span class="jq-brand"><%= Jquard.config.brand_name %></span>
+    </div>
 
-<%= yield %>
+    <div class="jq-topbar-end">
+      <%= render "jquard/user_menu" %>
+    </div>
+  </header>
 
+  <div class="jq-shell">
+    <aside class="jq-sidebar">
+      <nav class="jq-sidebar-nav">
+        <% jquard_navigation.each do |group, resources| %>
+          <div>
+            <% if group %>
+              <p class="jq-nav-group-label"><%= group %></p>
+            <% end %>
+            <ul class="jq-nav-items">
+              <% resources.each do |resource| %>
+                <li>
+                  <%= link_to resource_path(resource.slug),
+                        class: class_names("jq-nav-item", "jq-nav-item--active" => params[:resource_slug] == resource.slug) do %>
+                    <%= jquard_icon(resource.navigation_icon, css_class: "jq-nav-item-icon") %>
+                    <span><%= resource.navigation_label %></span>
+                  <% end %>
+                </li>
+              <% end %>
+            </ul>
+          </div>
+        <% end %>
+      </nav>
+    </aside>
+
+    <div class="jq-main">
+      <main class="jq-content">
+        <% if notice.present? %>
+          <div class="jq-toast" role="status">
+            <%= jquard_icon("check-circle", css_class: "jq-toast-icon") %>
+            <span><%= notice %></span>
+          </div>
+        <% end %>
+
+        <%= yield %>
+      </main>
+    </div>
+  </div>
+
+  <dialog id="jquard-confirm-dialog" class="jq-modal">
+    <div class="jq-modal-window">
+      <div class="jq-modal-icon-circle">
+        <%= jquard_icon("trash", css_class: "jq-modal-icon") %>
+      </div>
+      <h2 class="jq-modal-heading" data-slot="heading"></h2>
+      <p class="jq-modal-description" data-slot="description"></p>
+      <form method="dialog" class="jq-modal-actions">
+        <button value="" class="jq-btn jq-btn--secondary">Cancel</button>
+        <button value="confirm" class="jq-btn jq-btn--danger" data-slot="confirm">Confirm</button>
+      </form>
+    </div>
+  </dialog>
 </body>
 </html>

data/app/views/layouts/jquard/auth.html.erb

@@ -0,0 +1,44 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title><%= Jquard.config.brand_name %></title>
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= jquard_theme_style %>
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag "jquard/application", media: "all" %>
+</head>
+<body class="jq-body">
+  <% if notice.present? %>
+    <div class="jq-toast" role="status">
+      <%= jquard_icon("check-circle", css_class: "jq-toast-icon") %>
+      <span><%= notice %></span>
+    </div>
+  <% end %>
+
+  <main class="jq-auth">
+    <div class="jq-auth-card">
+      <header class="jq-auth-header">
+        <span class="jq-brand"><%= Jquard.config.brand_name %></span>
+
+        <% if content_for?(:heading) %>
+          <h1 class="jq-auth-heading"><%= yield :heading %></h1>
+        <% end %>
+
+        <% if content_for?(:subheading) %>
+          <p class="jq-auth-subheading"><%= yield :subheading %></p>
+        <% end %>
+      </header>
+
+      <% if alert.present? %>
+        <p class="jq-auth-flash jq-auth-flash--alert" role="alert"><%= alert %></p>
+      <% end %>
+
+      <%= yield %>
+    </div>
+  </main>
+</body>
+</html>

data/config/routes.rb

@@ -1,2 +1,15 @@
 Jquard::Engine.routes.draw do
+  root to: "resources#root"
+
+  # Fixed routes must be declared above this line: ":resource_slug" matches
+  # any first segment, so anything below it would be unreachable.
+  scope ":resource_slug" do
+    get "/", to: "resources#index", as: :resource
+    get "create", to: "resources#new", as: :new_resource
+    post "/", to: "resources#create"
+    get ":record_id/edit", to: "resources#edit", as: :edit_resource
+    patch ":record_id", to: "resources#update", as: :resource_record
+    put ":record_id", to: "resources#update"
+    delete ":record_id", to: "resources#destroy"
+  end
 end

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

@@ -0,0 +1,33 @@
+require "rails/generators"
+
+module Jquard
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      class_option :path, type: :string, default: "admin",
+        desc: "Mount path for the admin panel"
+
+      def add_mount_route
+        route %(mount Jquard::Engine => "/#{options[:path]}")
+      end
+
+      def create_initializer
+        template "initializer.rb.tt", "config/initializers/jquard.rb"
+      end
+
+      def show_next_steps
+        say ""
+        say "Jquard is mounted at /#{options[:path]}.", :green
+        say ""
+        say "Next: install devise and configure authentication in config/initializers/jquard.rb —", :yellow
+        say "if you do not want your admin panel exposed.", :yellow
+        say ""
+        say "Then generate your first resource with:", :green
+        say ""
+        say "  bin/rails generate jquard:resource YourModel", :bold
+        say ""
+      end
+    end
+  end
+end

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

@@ -0,0 +1,20 @@
+Jquard.configure do |config|
+  config.brand_name = <%= Rails.application.class.module_parent_name.titleize.inspect %>
+
+  # The primary color accepts a built-in palette name or a full Tailwind-style
+  # hash of shades (50, 100, ..., 950).
+  #
+  # config.primary_color = :ruby
+  # config.primary_color = { 50 => "#eff6ff", 100 => "#dbeafe", ..., 950 => "#172554" }
+
+  # WARNING: the panel is currently PUBLIC — an empty block means "no
+  # authentication". Do not deploy it this way.
+  #
+  # Jquard does not ship authentication; bring your own. Once Devise is
+  # installed, replace the empty block with the three lines below.
+  # See the README for the full walkthrough.
+  config.authenticate_with { }
+  # config.authenticate_with { authenticate_user! }
+  # config.current_user_method = :current_user
+  # config.sign_out_path = -> { main_app.destroy_user_session_path }
+end