Drupal Radix Theme
  • Introduction
    • Overview & Support
  • Installation
    • Requirements
    • Getting Started
    • Setup with ddev
  • Understanding Radix
    • Individual files and directories
    • Bootstrap Build
    • Bootswatch
  • Working with the components
    • Components: Intro
    • Components: A deep dive
    • An example component
    • The drupal-radix-cli
    • Copy and modify a component
  • Components
    • Accordion
    • Alerts
    • Badge
    • Block
    • Buttons
    • Button Group
    • Breadcrumb
    • Card
    • Carousel
    • Close button
    • Comment
    • Collapse
    • Details
    • Dropdown menu
    • Field
    • Field Comment
    • Fieldset
    • Figure
    • Form
    • Form: Element
    • Form Element Label
    • Form Element: Radio Checkbox
    • Heading
    • HTML
    • Image
    • Input
    • List group
    • Local Tasks
    • Media
    • Modal
    • Nav
    • Nav Item
    • Navbar
    • Navbar Brand
    • Node
    • Offcanvas
    • Page
    • Page: Content
    • Page: Footer
    • Page: Navigation
    • Page: Title
    • Pagination
    • Progress
    • Radios
    • Region
    • Select
    • Spinners
    • Table
    • Taxonomy
    • Textarea
    • Toasts
    • Tooltips
    • User
    • Views: view
    • Views: view--grid
    • Views: view--table
    • Views: view--unformatted
  • Misc
    • Migration and upgrading
    • Roadmap
    • Credits & Contributions
Powered by GitBook
On this page
  • The Bootstrap side
  • The Radix side

Was this helpful?

  1. Misc

Migration and upgrading

How to upgrade from 5.x, 4.x or even 3.x

PreviousViews: view--unformattedNextRoadmap

Last updated 1 year ago

Was this helpful?

Generally, migration between major versions has two sides to it:

  • What's changed in Radix itself

  • What's changed in Bootstrap

This is a time-consuming process and not a scripted approach. The ideal suggested approach is a manual migration, meaning start fresh and move everything from your old theme into the new one:

  • Upgrade your parent Radix theme to the latest version

  • Create a new sub-theme

  • Move over your custom components into your new theme

  • Update the bootstrap variables

  • Update utility-classes in each component

  • Define a [COMPONENT-NAME].component.yml file

  • Migrate your *.theme files into your new theme

  • Migrate and possibly update your *.JS file

  • Build your theme and test it

The Bootstrap side

For instance, the Radix 3.x comes with Bootstrap 3, Radix 4.x comes with Bootstrap 4, and Radix 5.x with Bootstrap 5. First off you need

migrating means that you need to:

  • Check your deprecated classes and update them accordingly

  • Check your deprecated variables and mixins , etc... and update them accordingly.

  • Remove any jQuery code and dependencies

  • Upgrade your node packages like popperJS

  • Replace your Libsass with the Dart Sass

  • For the Sass part, check the breaking changes in the

  • etc...

The Radix side

Radix has switched to using Drupal core's SDC, so a lot has changed, with that in mind, we are still using rather the same component approach that we had as before, so it's not that hard to recreate our components.

Mind the deprecated components and newly added ones, search for *.twig within your template files and see if all of those components are updated and in place.

the migration documentation on Bootstrap
Bootstrap docs