Skip to content

v5 upgrade guide

tanthammar edited this page Oct 30, 2020 · 2 revisions

This release contains breaking changes.

Credits to @maxeckel

Max volunteered to help me refactor the TailwindUI markup to pure TailwindCss and he has been a great support during the development of this release. Thank you !!!

Upgrade guide

  • config/tall-themes.php
    • save a copy of your current config file
    • republish the config file: php artisan vendor:publish --tag=tall-form-config
  • publish the theme, se note below
    • if you made changes to the css markup in your old config file, copy/paste to the tall-theme css file
  • tailwind.config.js
    • remove the nord-theme colors: {}
  • backup your icons
    • publish the new icons, see note below
    • if you have custom icons, change the new config file and put your custom icons in the correct folder.
  • remove .svg-icon class from your current css (included in the default theme file)
  • remove Nord theme colors from tailwind.config.js - if you don't use them. Not required in the default theme.
  • add support for @apply with complex classes to tailwind.config.js - see Theme wiki page
  • if you extended any Blade component classes, review them
  • if you replaced/published any view files, review them

New: Custom Themes

  • There has been some changes to the styling of all fields to avoid TailwindUI license violation.
  • Classes are moved from config/tall-forms.php to tall-theme
  • Most classes are moved from the Blade component classes to tall-theme
  • Most classes are moved from the view files to tall-theme
  • Theme classes use tf prefix. example .tf-bg-primary or .tf-text-primary
  • Nord theme is moved to separate tall-nord-theme file - sponsors only
  • New classes and colors for success, danger, warning, info, primary, secondary
  • Publish the theme files:
    • Laravel 8, css: php artisan vendor:publish --tag=tall-form-theme-css
    • Laravel 7, scss: php artisan vendor:publish --tag=tall-form-theme-sass
    • Import @import 'tall-theme' to app.css or app.scss (read wiki about nested css setup)
    • npm run dev

New: Search field

  • Two versions, one with a simple dropdown and one with labels and info. (docs coming)

New Trix

  • Two versions, with and without attachments. Supports native Livewire file-uploads.

New Icons

  • New icons for trash, sort and more.
  • All required icons are included in the package.
  • Apply styling to the icons in the theme file.
  • Publish the icons:
    • php artisan vendor:publish --tag=tall-form-icons

ImageCropper

  • new icons, new button sizes, new button colors

Repeater

  • new icons, new button sizes, new button colors

FileUpload

  • new icons, new button sizes, new button colors

Other

  • php dependency change to v7.4, PR #33

Fixes

  • added some wire:keys to loops
  • ImageCropper js error removed (Thanks to @maxeckel )
Clone this wiki locally