avo 1.1.0.pre.1 → 1.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 79ea9abeef39c823c788a203c6372e573c8913b87cd527f068ef68e4edacf33e
-  data.tar.gz: 35d012617f32c023a22e433d38dffa4a9afca7d595b9d794f043bf23c1078bc3
+  metadata.gz: a4c143d0dc69f79a8ae887f3637ac3829dc419533d04dcad9d55338ac63421b7
+  data.tar.gz: c55cc034329fdd73bc72c07e280e43d97de9aeff7344703326ddbea36f2c5cc9
 SHA512:
-  metadata.gz: ccc3dfa9da2d4a868a8bb13822b869500c3ea314558e498163ae75e17095f9ac72f62ab8275dbb78b187c4f9369dc901fb6ae8db7f2b032dfd8e56bb5930361f
-  data.tar.gz: 784f34eeabdfb3d2fde49cfe770a81f982a13fdf2a2ae520631dfcbc59a154be8ae19f0948d3636256e51ce39a627ae0ef2020284f80c950c21d993f21b68319
+  metadata.gz: 6a16c12d19c195b0017760fae9e86c65aae3fda91b7f3b180985969bdc968e8bc1ef11c6266ad35fe7e652aa57bf0dedf3c53adc91489349b0c05573243ef2ce
+  data.tar.gz: f10af3e7ed324e6dd716866752b800e639d01b6eff3b79c38caed2ef11a8f2795271d8b20053b118aead1abf9752dfe712a297cee844c0f3718357234aa76fed

data/Gemfile

@@ -52,7 +52,7 @@ gem "byebug", platforms: [:mri, :mingw, :x64_mingw]
 gem "dotenv-rails"
 # Access an interactive console on exception pages or by calling 'console' anywhere in the code.
 gem "web-console", ">= 3.3.0"
-gem "listen", ">= 3.3.0"
+gem "listen", ">= 3.5.1"
 # Spring speeds up development by keeping your application running in the background. Read more: https://github.com/rails/spring
 gem "spring"
 
@@ -119,3 +119,7 @@ gem "view_component", require: "view_component/engine"
 gem "addressable"
 
 gem "appraisal"
+
+gem 'meta-tags'
+
+gem 'breadcrumbs_on_rails'

data/Gemfile.lock

@@ -1,13 +1,15 @@
 PATH
   remote: .
   specs:
-    avo (1.1.0.pre.1)
+    avo (1.2.5)
       active_link_to
       addressable
+      breadcrumbs_on_rails
       countries
       hotwire-rails
       httparty
       image_processing
+      meta-tags
       pagy
       pundit
       rails (>= 6.0)
@@ -87,6 +89,8 @@ GEM
     bindex (0.8.1)
     bootsnap (1.4.8)
       msgpack (~> 1.0)
+    breadcrumbs_on_rails (4.0.0)
+      rails (>= 5.0)
     builder (3.2.4)
     bump (0.9.0)
     byebug (11.1.3)
@@ -161,6 +165,8 @@ GEM
     mail (2.7.1)
       mini_mime (>= 0.1.1)
     marcel (1.0.0)
+    meta-tags (2.14.0)
+      actionpack (>= 3.2.0, < 6.2)
     method_source (1.0.0)
     mime-types (3.3.1)
       mime-types-data (~> 3.2015)
@@ -356,6 +362,7 @@ DEPENDENCIES
   appraisal
   avo!
   bootsnap (>= 1.4.2)
+  breadcrumbs_on_rails
   bump
   byebug
   capybara (>= 2.15)
@@ -372,7 +379,8 @@ DEPENDENCIES
   image_processing (~> 1.2)
   iso
   jbuilder (~> 2.7)
-  listen (>= 3.3.0)
+  listen (>= 3.5.1)
+  meta-tags
   pg (>= 0.18, < 2.0)
   puma (~> 4.3.5)
   pundit

data/app/components/avo/index/grid_cover_empty_state_component.html.erb

@@ -0,0 +1,3 @@
+<div class="absolute bg-gray-100 w-full h-full">
+  <%= helpers.svg 'avocado', class: 'relative transform -translate-x-1/2 -translate-y-1/2 h-20 text-gray-400 inset-auto top-1/2 left-1/2' %>
+</div>

data/app/components/avo/index/grid_cover_empty_state_component.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+class Avo::Index::GridCoverEmptyStateComponent < ViewComponent::Base
+end

data/app/components/avo/index/grid_item_component.html.erb

@@ -4,7 +4,9 @@
   <div class="relative w-full pb-3/4 rounded-t-xl overflow-hidden">
     <%== item_selector_input floating: true, size: :lg %>
 
-    <% if cover.respond_to? :to_image %>
+    <% if cover.blank? %>
+      <%= render Avo::Index::GridCoverEmptyStateComponent.new %>
+    <% elsif cover.respond_to? :to_image %>
       <%= link_to_if cover.link_to_resource, image_tag(cover.to_image, class: 'absolute h-full w-full object-cover'), helpers.resource_path(@resource.model), class: 'absolute h-full w-full object-cover', title: title.value %>
     <% elsif cover.type == 'file' %>
       <% if cover.value.attached? && cover.value.representable? %>
@@ -18,9 +20,7 @@
       <% if cover.value.present? %>
         <%= link_to_if cover.link_to_resource, image_tag(cover.value, class: 'absolute h-full w-full object-cover'), helpers.resource_path(@resource.model), class: 'absolute h-full w-full object-cover', title: title.value %>
       <% else %>
-        <div class="absolute bg-gray-100 w-full h-full">
-          <%= helpers.svg 'avocado', class: 'relative transform -translate-x-1/2 -translate-y-1/2 h-20 text-gray-400 inset-auto top-1/2 left-1/2' %>
-        </div>
+        <%= render Avo::Index::GridCoverEmptyStateComponent.new %>
       <% end %>
     <% end %>
   </div>

data/app/components/avo/modal_component.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
 class Avo::ModalComponent < ViewComponent::Base
-  with_content_areas :heading, :controls
+  renders_one :heading
+  renders_one :controls
 end

data/app/components/avo/panel_component.html.erb

@@ -1,7 +1,12 @@
 <div <%== data_attributes %>>
   <div class="mb-6">
-    <div class="text-2xl tracking-normal font-bold text-gray-800 truncate mb-3">
-      <%= @title %>
+    <div>
+      <div class="breadcrumbs">
+        <%= helpers.render_breadcrumbs(separator: helpers.svg('chevron-right', class: 'inline-block h-3 stroke-current relative top-[-1px] ml-1' )) if Avo.configuration.display_breadcrumbs %>
+      </div>
+      <div class="text-2xl tracking-normal font-bold text-gray-800 truncate">
+        <%= @title %>
+      </div>
     </div>
 
     <div>

data/app/components/avo/panel_component.rb

@@ -1,7 +1,10 @@
 # frozen_string_literal: true
 
 class Avo::PanelComponent < ViewComponent::Base
-  with_content_areas :tools, :body, :bare_content, :footer
+  renders_one :tools
+  renders_one :body
+  renders_one :bare_content
+  renders_one :footer
 
   def initialize(title: nil, body_classes: nil, data: {})
     @title = title

data/app/components/avo/show/fields/has_one_field_component.html.erb

@@ -3,14 +3,14 @@
     <%= render(Avo::LoadingComponent.new(title: @field.name)) %>
   </turbo-frame>
 <% else %>
-  <%= panel(title: @field.id.capitalize) do |c| %>
-    <% c.with :tools do %>
+  <%= render Avo::PanelComponent.new(title: @field.id.capitalize) do |c| %>
+    <% c.tools do %>
       <%= a_link helpers.resource_attach_path(@resource.model.model_name.route_key, @resource.model.id, @field.id), color: 'indigo', 'data-turbo-frame': 'attach_modal' do %>
         <%= svg 'view-grid-add' %> <%= t('avo.attach_item', item: @field.id).capitalize %>
       <% end %>
     <% end %>
 
-    <% c.with :body do %>
+    <% c.body do %>
       <div class="py-8 flex justify-center items-center">
         <%= empty_state @field.id %>
       </div>

data/app/components/avo/views/resource_edit_component.html.erb

@@ -3,8 +3,8 @@
     <%= form_with model: @resource.model, url: helpers.resource_path(@resource.model), method: :put, multipart: true do |form| %>
       <%= hidden_field_tag :referrer, back_path if params[:via_resource_class] %>
 
-      <%= panel(title: resource_panel[:name]) do |component| %>
-        <% component.with :tools do %>
+      <%= render Avo::PanelComponent.new(title: resource_panel[:name]) do |c| %>
+        <% c.tools do %>
           <div class="flex justify-end space-x-2">
             <%= a_link back_path do %>
               <%= helpers.svg 'arrow-left' %> <%= t('avo.cancel').capitalize %>
@@ -18,7 +18,7 @@
           </div>
         <% end %>
 
-        <% component.with :body do %>
+        <% c.body do %>
           <% @resource.get_fields.each_with_index do |field, index| %>
             <%= edit_field field, index, @resource, form unless field.computed %>
           <% end %>

data/app/components/avo/views/resource_index_component.html.erb

@@ -1,5 +1,5 @@
-<%= panel title: title, body_classes: 'py-4', data: { component: 'resources-index' } do |c| %>
-  <% c.with :tools do %>
+<%= render Avo::PanelComponent.new title: title, body_classes: 'py-4', data: { component: 'resources-index' } do |c| %>
+  <% c.tools do %>
     <%= render 'actions' if @actions.present? %>
 
     <% if can_create? %>
@@ -21,7 +21,7 @@
     <% end %>
   <% end %>
 
-  <% c.with :body do %>
+  <% c.body do %>
     <div class="flex justify-between py-6 min-h-24"
       data-selected-resources-name="<%= @resource.plural_name.downcase %>"
       data-selected-resources="[]"
@@ -51,7 +51,7 @@
   <% end %>
 
   <% if view_type.to_sym == :grid %>
-    <% c.with :bare_content do %>
+    <% c.bare_content do %>
       <%= render Avo::Index::ResourceGridComponent.new(resources: @resources, resource: @resource, reflection: @reflection, parent_model: @parent_model) %>
 
       <div class="bg-white rounded-xl shadow-xl mt-8 py-6">

data/app/components/avo/views/resource_new_component.html.erb

@@ -1,8 +1,8 @@
 <div>
   <% @resource.panels.each do |resource_panel| %>
     <%= form_with model: @resource.model, url: helpers.resources_path(@resource.model, via_relation_class: params[:via_relation_class], via_resource_id: params[:via_resource_id]), local: true, multipart: true do |form| %>
-      <%= panel(title: resource_panel[:name]) do |component| %>
-        <% component.with :tools do %>
+      <%= render Avo::PanelComponent.new(title: resource_panel[:name]) do |c| %>
+        <% c.tools do %>
           <div class="flex justify-end space-x-2">
             <%= a_link back_path do %>
               <%= svg 'arrow-left' %> <%= t('avo.cancel').capitalize %>
@@ -14,7 +14,7 @@
           </div>
         <% end %>
 
-        <% component.with :body do %>
+        <% c.body do %>
           <% @resource.get_fields.each_with_index do |field, index| %>
             <%= edit_field field, index, @resource, form unless field.computed %>
           <% end %>

data/app/components/avo/views/resource_show_component.html.erb

@@ -4,7 +4,7 @@
 >
   <% @resource.panels.each do |resource_panel| %>
     <%= render(Avo::PanelComponent.new(title: resource_panel[:name])) do |c| %>
-      <% c.with :tools do %>
+      <% c.tools do %>
         <% if resource_panel[:name] == @resource.default_panel_name %>
           <%= render 'actions' %>
 
@@ -44,7 +44,7 @@
         <% end %>
       <% end %>
 
-      <% c.with :body do %>
+      <% c.body do %>
         <% if fields_by_panel[resource_panel[:name]].present? %>
           <% fields_by_panel[resource_panel[:name]].each_with_index do |field, index| %>
             <%= show_field field, index, @resource %>

data/app/controllers/avo/application_controller.rb

@@ -7,6 +7,7 @@ module Avo
     before_action :set_authorization
     before_action :_authenticate!
     before_action :set_container_classes
+    before_action :add_initial_breadcrumbs
 
     rescue_from Pundit::NotAuthorizedError, with: :render_unauthorized
     rescue_from ActiveRecord::RecordInvalid, with: :exception_logger
@@ -240,5 +241,9 @@ module Avo
 
       @container_classes = contain ? "2xl:container 2xl:mx-auto" : ""
     end
+
+    def add_initial_breadcrumbs
+      instance_eval(&Avo.configuration.initial_breadcrumbs) if Avo.configuration.initial_breadcrumbs.present?
+    end
   end
 end

data/app/controllers/avo/base_controller.rb

@@ -9,6 +9,9 @@ module Avo
     before_action :set_model, only: [:show, :edit, :destroy, :update]
 
     def index
+      @page_title = resource_name.humanize
+      add_breadcrumb resource_name.humanize
+
       set_index_params
       set_filters
       set_actions
@@ -48,15 +51,28 @@ module Avo
       set_actions
 
       @resource = @resource.hydrate(model: @model, view: :show, user: _current_user, params: params)
+
+      @page_title = @resource.default_panel_name
+      add_breadcrumb resource_name.humanize, resources_path(@resource.model_class)
+      add_breadcrumb @resource.model_title
     end
 
     def new
       @model = @resource.model_class.new
       @resource = @resource.hydrate(model: @model, view: :new, user: _current_user)
+
+      @page_title = @resource.default_panel_name
+      add_breadcrumb resource_name.humanize, resources_path(@resource.model_class)
+      add_breadcrumb t("avo.new").humanize
     end
 
     def edit
       @resource = @resource.hydrate(model: @model, view: :edit, user: _current_user)
+
+      @page_title = @resource.default_panel_name
+      add_breadcrumb resource_name.humanize, resources_path(@resource.model_class)
+      add_breadcrumb @resource.model_title, resource_path(@resource.model)
+      add_breadcrumb t("avo.edit").humanize
     end
 
     def create

data/app/controllers/avo/home_controller.rb

@@ -3,7 +3,11 @@ require_dependency "avo/application_controller"
 module Avo
   class HomeController < ApplicationController
     def index
-      unless Rails.env.development?
+      @page_title = "Get started"
+
+      if Avo.configuration.home_path.present?
+        redirect_to Avo.configuration.home_path
+      elsif !Rails.env.development?
         redirect_to resources_path Avo::App.get_resources.min_by { |resource| resource.route_key }.model_class
       end
     end

data/app/helpers/avo/application_helper.rb

@@ -21,12 +21,6 @@ module Avo
       }
     end
 
-    def panel(**args, &block)
-      render(Avo::PanelComponent.new(**args)) do |component|
-        capture(component, &block)
-      end
-    end
-
     def empty_state(resource_name)
       render partial: "avo/partials/empty_state", locals: {resource_name: resource_name}
     end

data/app/packs/entrypoints/application.css

@@ -14,6 +14,7 @@
 @import './../stylesheets/alerts.css';
 @import './../stylesheets/loader.css';
 @import './../stylesheets/pagination.css';
+@import './../stylesheets/breadcrumbs.css';
 
 @import './../stylesheets/components/status.css';
 @import './../stylesheets/components/code.css';

data/app/packs/stylesheets/breadcrumbs.css

@@ -0,0 +1,12 @@
+.breadcrumbs {
+  @apply relative text-sm text-gray-400 font-bold;
+
+  a,
+  span {
+    @apply inline-block text-gray-400;
+  }
+
+  a {
+    @apply hover:text-gray-500;
+  }
+}

data/app/packs/stylesheets/components/code.css

@@ -9,3 +9,8 @@
   height: var(--height) !important;
   min-height: auto;
 }
+
+/* overlay CodeMirror fullscreen & Preview on small screens */
+.CodeMirror-fullscreen, .editor-preview-active-side {
+  z-index: 50;
+}

data/app/packs/svgs/chevron-right.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" class="h-6 w-6" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+  <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 5l7 7-7 7" />
+</svg>

data/app/views/avo/actions/show.html.erb

@@ -9,7 +9,7 @@
   >
     <%= form_with model: @model, scope: 'fields', url: "/avo/resources/#{@resource.model_class.model_name.route_key}/actions/#{@action.param_id}", data: {'turbo-frame': '_top', 'action-target': 'form'} do |form| %>
       <%= render Avo::ModalComponent.new do |c| %>
-        <% c.with :heading do %>
+        <% c.heading do %>
           <%= @action.name %>
         <% end %>
 
@@ -25,7 +25,7 @@
           <% end %>
         <% end %>
 
-        <% c.with :controls do %>
+        <% c.controls do %>
           <%= a_button @action.cancel_button_label, 'data-action': 'click->modal#close', size: :sm %>
           <%= a_button @action.confirm_button_label, type: :submit, color: :green, size: :sm %>
         <% end %>

data/app/views/avo/home/_actions.html.erb

@@ -1,16 +1,16 @@
 <div>
   <h3>Actions</h3>
 
-  <div class="mt-2" data-controller="hidden-input">
+  <div class="mt-2">
     Avo actions allow you to perform specific tasks on one or more of your records. For example, you might want to mark a user as inactive and optionally send a message that may be customized by the person that wants to run the action.
 
-    <strong class="cursor-pointer block mt-2" data-action="click->hidden-input#showContent">Generate action 👇</strong>
-
-    <div class="mt-2 hidden" data-hidden-input-target="content">
+    <div class="mt-2">
       <code class="text-lg">Toggle published</code>
-      <div>
+      <div class="mt-1">
         <code class="p-1 rounded bg-light-blue-500 text-white">bin/rails generate avo:action toggle_published</code>
       </div>
     </div>
+
+    <a href="https://docs.avohq.io/1.0/actions.html" target="_blank" title="Avo Actions documentation" class="text-bold cursor-pointer block mt-2">Actions in the docs 👉</a>
   </div>
 </div>

data/app/views/avo/home/_docs.html.erb

@@ -4,6 +4,6 @@
   <div class="mt-2">
     We take pride in our documentation. Please check it out to see what you can build with Avo
 
-    <a href="https://docs.avohq.io" class="text-bold cursor-pointer block mt-2">Check out the docs 👉</a>
+    <a href="https://docs.avohq.io" target="_blank" title="Avo documentation" class="text-bold cursor-pointer block mt-2">Check out the docs 👉</a>
   </div>
 </div>

data/app/views/avo/home/_filters.html.erb

@@ -4,13 +4,13 @@
   <div class="mt-2" data-controller="hidden-input">
     Filters allow you to better scope the index queries for records you are looking for.
 
-    <strong class="cursor-pointer block mt-2" data-action="click->hidden-input#showContent">Generate filter 👇</strong>
-
-    <div class="mt-2 hidden" data-hidden-input-target="content">
+    <div class="mt-2">
       <code class="text-lg">Published filter</code>
-      <div>
+      <div class="mt-1">
         <code class="p-1 rounded bg-light-blue-500 text-white">bin/rails generate avo:filter published_filter</code>
       </div>
     </div>
+
+    <a href="https://docs.avohq.io/1.0/filters.html" target="_blank" title="Avo Filters documentation" class="text-bold cursor-pointer block mt-2">Filters in the docs 👉</a>
   </div>
 </div>