tiny_admin 0.1.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: afea7b433e47bdf47e2682a334e2ffe7761e6e341aec9b43746291faf4d16406
-  data.tar.gz: 6c53fbae6a6c6749ef423bbd190094c25149abae29c6c235bf49f13fb3d6906a
+  metadata.gz: aa8eb3987f51f28c4f9a55c62fddfd521accf075aac9be4d0b4fab7e88145770
+  data.tar.gz: 98e2f4af557280ca167816fa325f824d5eda99cde96d35407d472ab1e37b370d
 SHA512:
-  metadata.gz: 4b9701bccac2aa19c6fb838c037e0522d6ee8d3560ec1d5aa743725a64d1c2e4bfc7369faaef9bdc6b98da280f8f1d82c302fadfae5620fe1e958857238005c4
-  data.tar.gz: 16763a9cdf6df77cc261f5a5493803a55cd41756888026fb93ccdf66bf7c6fe7412482b39a666fd026892787addeb55c80adef45b1af479b0f062eb7276aaa53
+  metadata.gz: 501e766d535a08b80597c7e5e9c5c40c075a74d1ddf347ad6d0858600c37fb945e39616a7d3b62d91a9486484a6a7d5edbd59fdfaca7e373fa099ecb8092edef
+  data.tar.gz: cfd95059d66a9f5d83b60086b5b59d01840fc654e929546778d02457605d6bca1b22cf3f587a92db93575464281ef0f1cd7993a2082bd234ef91c124e84b5ad7

data/README.md

@@ -1,40 +1,51 @@
 # Tiny Admin
 
-A compact and composible dashboard component for Ruby.
+[![Gem Version](https://badge.fury.io/rb/tiny_admin.svg)](https://badge.fury.io/rb/tiny_admin) [![Linters](https://github.com/blocknotes/tiny_admin/actions/workflows/linters.yml/badge.svg)](https://github.com/blocknotes/tiny_admin/actions/workflows/linters.yml) [![Specs Rails 7.0](https://github.com/blocknotes/tiny_admin/actions/workflows/specs_rails_70.yml/badge.svg)](https://github.com/blocknotes/tiny_admin/actions/workflows/specs_rails_70.yml)
 
-The main features are:
-- a Rack app that can be mounted in any Rack-enabled framework;
-- some features are handled as plugins, so they can be replaced with little effort;
-- routing is provided by Roda (which is small and performant);
-- views are Phlex components.
+A compact and composable dashboard component for Ruby.
 
-See (extra)[extra] folder for usage examples.
+Main features:
+- a Rack app that can be mounted in any Rack-enabled framework or used standalone;
+- structured with plugins also for main components that can be replaced with little effort;
+- routing is provided by Roda which is small and performant;
+- views are Phlex components, so plain Ruby objects for views, no assets are needed.
 
 Please ⭐ if you like it.
 
+![screenshot](extra/screenshot.png)
+
 ## Install
 
-- Add to your Gemfile: `gem 'tiny_admin'`
-- For a Rails project: add an initializer and the YAML config - see (configuration)[#configuration] below.
+- Add to your Gemfile: `gem 'tiny_admin', '~> 0.2'`
+- Mount the app in a route (check some examples with: Hanami, Rails, Roda and standalone in [extra](extra))
+  + in Rails, update _config/routes.rb_: `mount TinyAdmin::Router => '/admin'`
+- Configure the dashboard using `TinyAdmin.configure` and/or `TinyAdmin.configure_from_file` (see [configuration](#configuration) below):
 
-## Plugins and components
+```rb
+TinyAdmin.configure do |settings|
+  settings.root = {
+    title: 'Home',
+    page: Admin::PageRoot
+  }
+end
+```
 
-Every plugin or component can be replaced.
+## Plugins and components
 
 ### Authentication
 
-There are 2 plugins included:
-- _SimpleAuth_: provides a simple session authentication based on Warden (`warden` gem must be included in the host project);
+Plugins available:
+- _SimpleAuth_: session authentication based on Warden (`warden` gem must be included in the Gemfile) using a password hash provided via config or via environment variable (`ADMIN_PASSWORD_HASH`);
 - _NoAuth_: no authentication.
 
 ### Repository
 
-There is 1 plugin included:
+Plugin available:
 - _ActiveRecordRepository_: isolates the query layer to expose the resources in the admin interface.
 
 ### View pages
 
-There are 5 view pages included:
+Pages available:
 - _Root_: define how to present the content in the main page of the interface;
 - _PageNotFound_: define how to present pages not found;
 - _RecordNotFound_: define how to present record not found page;
@@ -44,7 +55,7 @@ There are 5 view pages included:
 
 ### View components
 
-There are 5 view components included:
+Components available:
 - _FiltersForm_: define how to present the filters form in the resource collection pages;
 - _Flash_: define how to present the flash messages;
 - _Head_: define how to present the Head tag;
@@ -53,23 +64,118 @@ There are 5 view components included:
 
 ## Configuration
 
-TinyAdmin can be configured programmatically or using a YAML config.
+TinyAdmin can be configured using a YAML file and/or programmatically.
+See [extra](extra) folder for some usage examples.
+
+The following options are supported:
+
+`root` (Hash): define the root section of the admin, properties:
+  - `title` (String): root section's title;
+  - `page` (String): a view object to render;
+  - `redirect` (String): alternative to _page_ option - redirects to a specific slug;
+
+Example:
+
+```yml
+root:
+  title: MyAdmin
+  redirect: posts
+```
+
+`authentication` (Hash): define the authentication method, properties:
+  - `plugin` (String): a plugin class to use (ex. `TinyAdmin::Plugins::SimpleAuth`);
+  - `password` (String): a password hash used by _SimpleAuth_ plugin (generated with `Digest::SHA512.hexdigest("some password")`).
+
+Example:
+
+```yml
+authentication:
+  plugin: TinyAdmin::Plugins::SimpleAuth
+  password: 'f1891cea80fc05e433c943254c6bdabc159577a02a7395dfebbfbc4f7661d4af56f2d372131a45936de40160007368a56ef216a30cb202c66d3145fd24380906'
+```
+
+`sections` (Array of hashes): define the admin sections, properties:
+  - `slug` (String): section reference identifier;
+  - `name` (String): section's title;
+  - `type` (String): the type of section: `url`, `page` or `resource`;
+  - other properties depends on the section's type.
+
+For _url_ sections:
+  - `url` (String): the URL to load when clicking on the section's menu item;
+  - `options` (Hash): properties:
+    + `target` (String): link _target_ attributes (ex. `_blank`).
+
+Example:
+
+```yml
+slug: google
+name: Google.it
+type: url
+url: https://www.google.it
+options:
+  target: '_blank'
+```
+
+For _page_ sections:
+  - `page` (String): a view object to render.
+
+Example:
+
+```yml
+slug: stats
+name: Stats
+type: page
+page: Admin::Stats
+```
+
+For _resource_ sections:
+  - `model` (String): the class to use to fetch the data on an item of a collection;
+  - `repository` (String): the class to get the properties related to the model;
+  - `index` (Hash): collection's action options;
+  - `show` (Hash): detail's action options;
+  - `collection_actions` (Array of hashes): custom collection's actions;
+  - `member_actions` (Array of hashes): custom details's actions;
+  - `only` (Array of strings): list of supported actions (ex. `index`);
+  - `options` (Array of strings): resource options (ex. `hidden`).
 
 Example:
 
+```yml
+slug: posts
+name: Posts
+type: resource
+model: Post
+```
+
+`style_links` (Array of hashes): list of styles files to include, properties:
+  - `href` (String): URL for the style file;
+  - `rel` (String): type of style file.
+
+`scripts` (Array of hashes): list of scripts to include, properties:
+  - `src` (String): source URL for the script.
+
+`extra_styles` (String): inline CSS styles.
+
+### Sample
+
 ```rb
 # config/initializers/tiny_admin.rb
 
-# hash generated using: Digest::SHA512.hexdigest("changeme")
-ENV['ADMIN_PASSWORD_HASH'] = 'f1891cea80fc05e433c943254c6bdabc159577a02a7395dfebbfbc4f7661d4af56f2d372131a45936de40160007368a56ef216a30cb202c66d3145fd24380906'
 config = Rails.root.join('config/tiny_admin.yml').to_s
 TinyAdmin.configure_from_file(config)
+
+# Change some settings programmatically
+TinyAdmin.configure do |settings|
+  settings.authentication[:password] = Digest::SHA512.hexdigest('changeme')
+end
 ```
 
 ```yml
+# config/tiny_admin.yml
 ---
 authentication:
   plugin: TinyAdmin::Plugins::SimpleAuth
+  # password: 'f1891cea80fc05e433c943254c6bdabc159577a02a7395df...' <= SHA512
 page_not_found: Admin::PageNotFound
 record_not_found: Admin::RecordNotFound
 root:

data/lib/tiny_admin/actions/index.rb

@@ -12,13 +12,12 @@ module TinyAdmin
         records, total_count = repository.list(page: current_page, limit: pagination, filters: filters, sort: sort)
         prepare_record = ->(record) { repository.index_record_attrs(record, fields: fields_options) }
         title = repository.index_title
-        pages = (total_count / pagination) + 1
+        pages = (total_count / pagination.to_f).ceil
 
-        prepare_page(Views::Actions::Index, title: title, context: context, query_string: query_string) do |page|
+        prepare_page(Views::Actions::Index, context: context) do |page|
           page.setup_pagination(current_page: current_page, pages: pages > 1 ? pages : false)
           page.setup_records(records: records, fields: fields, prepare_record: prepare_record)
-          page.actions = actions
-          page.filters = filters
+          page.update_attributes(actions: actions, filters: filters, query_string: query_string, title: title)
         end
       end
 
@@ -33,11 +32,12 @@ module TinyAdmin
         @sort = options[:sort] || ['id']
 
         @current_page = (params['p'] || 1).to_i
-        @query_string = params_to_s(params.reject { |k, _v| k == 'p' })
+        @query_string = params_to_s(params.except('p'))
       end
 
       def prepare_filters(fields, filters_list)
-        filters = (filters_list || []).map { _1.is_a?(Hash) ? _1 : { field: _1 } }.index_by { _1[:field] }
+        filters = (filters_list || []).map { _1.is_a?(Hash) ? _1 : { field: _1 } }
+        filters = filters.each_with_object({}) { |filter, result| result[filter[:field]] = filter }
         values = (params['q'] || {})
         fields.each_with_object({}) do |field, result|
           result[field] = { value: values[field.name], filter: filters[field.name] } if filters.key?(field.name)

data/lib/tiny_admin/actions/show.rb

@@ -11,9 +11,9 @@ module TinyAdmin
         prepare_record = ->(record_data) { repository.show_record_attrs(record_data, fields: fields_options) }
         fields = repository.fields(options: fields_options)
 
-        prepare_page(Views::Actions::Show, title: repository.show_title(record), context: context) do |page|
+        prepare_page(Views::Actions::Show, context: context) do |page|
           page.setup_record(record: record, fields: fields, prepare_record: prepare_record)
-          page.actions = actions
+          page.update_attributes(actions: actions, title: repository.show_title(record))
         end
       rescue Plugins::BaseRepository::RecordNotFound => _e
         prepare_page(options[:record_not_found_page] || Views::Pages::RecordNotFound)

data/lib/tiny_admin/authentication.rb

@@ -25,11 +25,11 @@ module TinyAdmin
 
     def render_login(notices: nil, warnings: nil, errors: nil)
       page = prepare_page(settings.authentication[:login], options: %i[no_menu compact_layout])
-      page.setup_flash_messages(
+      page.messages = {
         notices: notices || flash['notices'],
         warnings: warnings || flash['warnings'],
         errors: errors || flash['errors']
-      )
+      }
       render(inline: page.call)
     end
   end

data/lib/tiny_admin/basic_app.rb

@@ -17,14 +17,8 @@ module TinyAdmin
     plugin :render, engine: 'html'
     plugin :sessions, secret: SecureRandom.hex(64)
 
-    plugin authentication_plugin
+    plugin authentication_plugin, TinyAdmin::Settings.instance.authentication
 
     not_found { prepare_page(settings.page_not_found).call }
-
-    def attach_flash_messages(page)
-      return unless page.respond_to?(:setup_flash_messages)
-
-      page.setup_flash_messages(notices: flash['notices'], warnings: flash['warnings'], errors: flash['errors'])
-    end
   end
 end

data/lib/tiny_admin/plugins/simple_auth.rb

@@ -7,18 +7,19 @@ module TinyAdmin
     module SimpleAuth
       class << self
         def configure(app, opts = {})
+          @@opts = opts || {} # rubocop:disable Style/ClassVars
+          @@opts[:password] ||= ENV.fetch('ADMIN_PASSWORD_HASH', nil) # NOTE: fallback value
+
           Warden::Strategies.add(:secret) do
             def authenticate!
-              hash = ENV.fetch('ADMIN_PASSWORD_HASH')
-              secret = params['secret']
-              return fail(:invalid_credentials) if !secret || Digest::SHA512.hexdigest(secret) != hash
+              secret = params['secret'] || ''
+              return fail(:invalid_credentials) if Digest::SHA512.hexdigest(secret) != @@opts[:password]
 
               success!(app: 'TinyAdmin')
             end
           end
 
           app.opts[:login_form] = opts[:login_form] || TinyAdmin::Views::Pages::SimpleAuthLogin
-
           app.use Warden::Manager do |manager|
             manager.default_strategies :secret
             manager.failure_app = TinyAdmin::Authentication

data/lib/tiny_admin/router.rb

@@ -16,6 +16,12 @@ module TinyAdmin
         root_route(r)
       end
 
+      r.is do
+        # :nocov:
+        root_route(r)
+        # :nocov:
+      end
+
       r.post '' do
         context.slug = nil
         r.redirect settings.root_path
@@ -35,14 +41,16 @@ module TinyAdmin
     private
 
     def render_page(page)
-      attach_flash_messages(page)
+      if page.respond_to?(:messages=)
+        page.messages = { notices: flash['notices'], warnings: flash['warnings'], errors: flash['errors'] }
+      end
       render(inline: page.call)
     end
 
     def root_route(router)
       context.slug = nil
       if settings.root[:redirect]
-        router.redirect "#{settings.root_path}/#{settings.root[:redirect]}"
+        router.redirect route_for(settings.root[:redirect])
       else
         page = settings.root[:page]
         page_class = page.is_a?(String) ? Object.const_get(page) : page
@@ -60,66 +68,71 @@ module TinyAdmin
     def setup_resource_routes(router, slug, options:)
       router.on slug do
         context.slug = slug
-        setup_collection_routes(router, slug: slug, options: options)
-        setup_member_routes(router, slug: slug, options: options)
+        setup_collection_routes(router, options: options)
+        setup_member_routes(router, options: options)
       end
     end
 
-    def setup_collection_routes(router, slug:, options:)
+    def setup_collection_routes(router, options:)
       repository = options[:repository].new(options[:model])
-      index_options = options[:index] || {}
-      custom_actions = []
+      action_options = options[:index] || {}
 
       # Custom actions
-      (options[:collection_actions] || []).each do |custom_action|
-        action_slug, action = custom_action.first
-        action_class = action.is_a?(String) ? Object.const_get(action) : action
-        custom_actions << action_slug.to_s
-        router.get action_slug.to_s do
-          custom_action = action_class.new(repository, path: request.path, params: request.params)
-          render_page custom_action.call(app: self, context: context, options: index_options)
-        end
-      end
+      custom_actions = setup_custom_actions(
+        router,
+        options[:collection_actions],
+        repository: repository,
+        options: action_options
+      )
 
       # Index
       actions = options[:only]
       if !actions || actions.include?(:index) || actions.include?('index')
         router.is do
           index_action = TinyAdmin::Actions::Index.new(repository, path: request.path, params: request.params)
-          render_page index_action.call(app: self, context: context, options: index_options, actions: custom_actions)
+          render_page index_action.call(app: self, context: context, options: action_options, actions: custom_actions)
         end
       end
     end
 
-    def setup_member_routes(router, slug:, options:)
+    def setup_member_routes(router, options:)
       repository = options[:repository].new(options[:model])
-      show_options = (options[:show] || {}).merge(record_not_found_page: settings.record_not_found)
-      custom_actions = []
+      action_options = (options[:show] || {}).merge(record_not_found_page: settings.record_not_found)
 
       router.on String do |reference|
         context.reference = reference
 
         # Custom actions
-        (options[:member_actions] || []).each do |custom_action|
-          action_slug, action = custom_action.first
-          action_class = action.is_a?(String) ? Object.const_get(action) : action
-          custom_actions << action_slug.to_s
-
-          router.get action_slug.to_s do
-            custom_action = action_class.new(repository, path: request.path, params: request.params)
-            render_page custom_action.call(app: self, context: context, options: show_options)
-          end
-        end
+        custom_actions = setup_custom_actions(
+          router,
+          options[:member_actions],
+          repository: repository,
+          options: action_options
+        )
 
         # Show
         actions = options[:only]
         if !actions || actions.include?(:show) || actions.include?('show')
           router.is do
             show_action = TinyAdmin::Actions::Show.new(repository, path: request.path, params: request.params)
-            render_page show_action.call(app: self, context: context, options: show_options, actions: custom_actions)
+            render_page show_action.call(app: self, context: context, options: action_options, actions: custom_actions)
           end
         end
       end
     end
+
+    def setup_custom_actions(router, custom_actions, repository:, options:)
+      (custom_actions || []).map do |custom_action|
+        action_slug, action = custom_action.first
+        action_class = action.is_a?(String) ? Object.const_get(action) : action
+
+        router.get action_slug.to_s do
+          custom_action = action_class.new(repository, path: request.path, params: request.params)
+          render_page custom_action.call(app: self, context: context, options: options)
+        end
+
+        action_slug.to_s
+      end
+    end
   end
 end

data/lib/tiny_admin/settings.rb

@@ -35,11 +35,11 @@ module TinyAdmin
       @repository ||= Plugins::ActiveRecordRepository
       @resources ||= {}
       @root_path ||= '/admin'
+      @root_path = '/' if @root_path == ''
       @sections ||= []
 
       @root ||= {}
       @root[:title] ||= 'TinyAdmin'
-      @root[:path] ||= root_path
       @root[:page] ||= Views::Pages::Root
 
       if @authentication[:plugin] == Plugins::SimpleAuth
@@ -52,10 +52,10 @@ module TinyAdmin
       @components[:navbar] ||= Views::Components::Navbar
       @components[:pagination] ||= Views::Components::Pagination
 
-      @navbar = prepare_navbar(sections, root_path: root_path, logout: authentication[:logout])
+      @navbar = prepare_navbar(sections, logout: authentication[:logout])
     end
 
-    def prepare_navbar(sections, root_path:, logout:)
+    def prepare_navbar(sections, logout:)
       items = sections.each_with_object({}) do |section, list|
         slug = section[:slug]
         case section[:type]&.to_sym
@@ -64,7 +64,7 @@ module TinyAdmin
         when :page
           page = section[:page]
           pages[slug] = page.is_a?(String) ? Object.const_get(page) : page
-          list[slug] = [section[:name], "#{root_path}/#{slug}"]
+          list[slug] = [section[:name], route_for(slug)]
         when :resource
           repository = section[:repository] || settings.repository
           resources[slug] = {
@@ -73,7 +73,7 @@ module TinyAdmin
           }
           resources[slug].merge! section.slice(:resource, :only, :index, :show, :collection_actions, :member_actions)
           hidden = section[:options] && (section[:options].include?(:hidden) || section[:options].include?('hidden'))
-          list[slug] = [section[:name], "#{root_path}/#{slug}"] unless hidden
+          list[slug] = [section[:name], route_for(slug)] unless hidden
         end
       end
       items['auth/logout'] = logout if logout

data/lib/tiny_admin/utils.rb

@@ -13,20 +13,18 @@ module TinyAdmin
       list.join('&')
     end
 
-    def prepare_page(page_class, title: nil, context: nil, query_string: '', options: [])
+    def prepare_page(page_class, context: nil, options: nil)
       page_class.new.tap do |page|
-        page.setup_page(title: title, query_string: query_string, settings: settings)
-        page.setup_options(
-          context: context,
-          compact_layout: options.include?(:compact_layout),
-          no_menu: options.include?(:no_menu)
-        )
+        page.context = context
+        page.options = options
         yield(page) if block_given?
       end
     end
 
     def route_for(section, reference: nil, action: nil)
-      [settings.root_path, section, reference, action].compact.join("/")
+      root_path = settings.root_path == '/' ? nil : settings.root_path
+      route = [root_path, section, reference, action].compact.join("/")
+      route[0] == '/' ? route : route.prepend('/')
     end
 
     def context

data/lib/tiny_admin/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TinyAdmin
-  VERSION = '0.1.0'
+  VERSION = '0.2.1'
 end

data/lib/tiny_admin/views/actions/index.rb

@@ -5,7 +5,7 @@ module TinyAdmin
     module Actions
       class Index < DefaultLayout
         attr_reader :current_page, :fields, :pages, :prepare_record, :records
-        attr_accessor :actions, :filters
+        attr_accessor :actions, :filters, :query_string
 
         def setup_pagination(current_page:, pages:)
           @current_page = current_page
@@ -14,7 +14,7 @@ module TinyAdmin
 
         def setup_records(records:, fields:, prepare_record:)
           @records = records
-          @fields = fields.index_by(&:name)
+          @fields = fields.each_with_object({}) { |field, result| result[field.name] = field }
           @prepare_record = prepare_record
         end
 

data/lib/tiny_admin/views/basic_layout.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module TinyAdmin
+  module Views
+    class BasicLayout < Phlex::HTML
+      include Utils
+
+      def components
+        settings.components
+      end
+
+      def update_attributes(attributes)
+        attributes.each do |key, value|
+          send("#{key}=", value)
+        end
+      end
+    end
+  end
+end

data/lib/tiny_admin/views/components/flash.rb

@@ -6,10 +6,12 @@ module TinyAdmin
       class Flash < Phlex::HTML
         attr_reader :errors, :notices, :warnings
 
-        def initialize(notices: [], warnings: [], errors: [])
-          @notices = notices
-          @warnings = warnings
-          @errors = errors
+        def initialize(messages:)
+          return unless messages
+
+          @notices = messages[:notices]
+          @warnings = messages[:warnings]
+          @errors = messages[:errors]
         end
 
         def template

data/lib/tiny_admin/views/components/navbar.rb

@@ -4,10 +4,11 @@ module TinyAdmin
   module Views
     module Components
       class Navbar < Phlex::HTML
-        attr_reader :current_slug, :items, :root
+        attr_reader :current_slug, :items, :root_path, :root_title
 
-        def initialize(root:, items: [], current_slug: nil)
-          @root = root
+        def initialize(root_path:, root_title:, items: [], current_slug: nil)
+          @root_path = root_path
+          @root_title = root_title
           @items = items || []
           @current_slug = current_slug
         end
@@ -15,7 +16,7 @@ module TinyAdmin
         def template
           nav(class: 'navbar navbar-expand-lg') {
             div(class: 'container') {
-              a(class: 'navbar-brand', href: root[:path]) { root[:title] }
+              a(class: 'navbar-brand', href: root_path) { root_title }
               button(class: 'navbar-toggler', type: 'button', 'data-bs-toggle' => 'collapse', 'data-bs-target' => '#navbarNav', 'aria-controls' => 'navbarNav', 'aria-expanded' => 'false', 'aria-label' => 'Toggle navigation') {
                 span(class: 'navbar-toggler-icon')
               }

data/lib/tiny_admin/views/default_layout.rb

@@ -2,49 +2,25 @@
 
 module TinyAdmin
   module Views
-    class DefaultLayout < Phlex::HTML
-      include Utils
-
-      attr_reader :compact_layout,
-                  :context,
-                  :errors,
-                  :no_menu,
-                  :notices,
-                  :query_string,
-                  :settings,
-                  :title,
-                  :warnings
-
-      def setup_page(title:, query_string:, settings:)
-        @title = title
-        @query_string = query_string
-        @settings = settings
-      end
-
-      def setup_options(context:, compact_layout:, no_menu:)
-        @context = context
-        @compact_layout = compact_layout
-        @no_menu = no_menu
-      end
-
-      def setup_flash_messages(notices: [], warnings: [], errors: [])
-        @notices = notices
-        @warnings = warnings
-        @errors = errors
-      end
+    class DefaultLayout < BasicLayout
+      attr_accessor :context, :messages, :options, :title
 
       def template(&block)
-        items = no_menu ? [] : settings.navbar
-
         doctype
         html {
           render components[:head].new(title, style_links: style_links, extra_styles: settings.extra_styles)
 
           body(class: body_class) {
-            render components[:navbar].new(current_slug: context&.slug, root: settings.root, items: items)
+            navbar_attrs = {
+              current_slug: context&.slug,
+              root_path: settings.root_path,
+              root_title: settings.root[:title],
+              items: navbar_items
+            }
+            render components[:navbar].new(**navbar_attrs)
 
             main_content {
-              render components[:flash].new(notices: notices, warnings: warnings, errors: errors)
+              render components[:flash].new(messages: messages || {})
               yield_content(&block)
             }
 
@@ -55,29 +31,17 @@ module TinyAdmin
 
       private
 
-      def components
-        settings.components
-      end
-
-      def style_links
-        settings.style_links || [
-          # Bootstrap CDN
-          {
-            href: 'https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css',
-            rel: 'stylesheet',
-            integrity: 'sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65',
-            crossorigin: 'anonymous'
-          }
-        ]
-      end
-
       def body_class
         "module-#{self.class.to_s.split('::').last.downcase}"
       end
 
+      def navbar_items
+        options&.include?(:no_menu) ? [] : settings.navbar
+      end
+
       def main_content
         div(class: 'container main-content py-4') do
-          if compact_layout
+          if options&.include?(:compact_layout)
             div(class: 'row justify-content-center') {
               div(class: 'col-6') {
                 yield
@@ -89,10 +53,20 @@ module TinyAdmin
         end
       end
 
-      def render_scripts
-        return unless settings.scripts
+      def style_links
+        settings.style_links || [
+          # Bootstrap CDN
+          {
+            href: 'https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css',
+            rel: 'stylesheet',
+            integrity: 'sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65',
+            crossorigin: 'anonymous'
+          }
+        ]
+      end
 
-        settings.scripts.each do |script_attrs|
+      def render_scripts
+        (settings.scripts || []).each do |script_attrs|
           script(**script_attrs)
         end
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tiny_admin
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Mattia Roccoberton
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-07 00:00:00.000000000 Z
+date: 2023-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -16,43 +16,57 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.6'
+        version: '1'
 - !ruby/object:Gem::Dependency
   name: roda
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.66'
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.66'
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: tilt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.6'
-description: A compact and composible dashboard component for Ruby
+        version: '2'
+description: A compact and composable dashboard component for Ruby
 email: mat@blocknot.es
 executables: []
 extensions: []
@@ -78,6 +92,7 @@ files:
 - lib/tiny_admin/version.rb
 - lib/tiny_admin/views/actions/index.rb
 - lib/tiny_admin/views/actions/show.rb
+- lib/tiny_admin/views/basic_layout.rb
 - lib/tiny_admin/views/components/filters_form.rb
 - lib/tiny_admin/views/components/flash.rb
 - lib/tiny_admin/views/components/head.rb
@@ -94,7 +109,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/blocknotes/tiny_admin
   source_code_uri: https://github.com/blocknotes/tiny_admin
-  changelog_uri: https://github.com/blocknotes/tiny_admin/blob/master/CHANGELOG.md
+  changelog_uri: https://github.com/blocknotes/tiny_admin/blob/main/CHANGELOG.md
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -104,7 +119,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.7.0
+      version: 3.0.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="