v1.14.0

Possible Breaking Changes

Upgrade ruby 3.3.6 => 3.4.1

This release upgrades ruby to verison 3.4.1. You'll need to install it locally via whatever runtime manager you use (asdf is a good one if you're looking for recommendations) and then run bundle install to install all the gems for the new version.

This is a major ruby update. To prepare for upgrading your Bullet Train application you should make sure that all of your non-BT gems are up to date. You can see the status by running bundle outdated.

If you run into problems making this upgrade it's likely related to gems conflicting with the new ruby version. If you're having trouble getting things working, hit us up in Discord and we'll try to help.

Remove extended_email_reply_parser and charlock_holmes dependencies

NOTE This is only a breaking change if you use the bullet_train-conversations gem. If you're using that gem you should either:

• Update it to version 1.1.5 or later
• Add extended_email_reply_parser directly to your Gemfile

Upgrade node 22.11.0 => 22.12.0

This release upgrades node to version 22.12.0. You'll need to install it locally via whatever runtime manager you use (asdf is a good one if you're looking for recommendations) and then do the following to install yarn and all the JS dependencies:

npm install -g yarn
corepack enable
yarn install

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-12-24) by @depfu in #1840
• [js] Update all Yarn dependencies (2024-12-24) by @depfu in #1841
• [ruby] Update all Bundler dependencies (2024-12-25) by @depfu in #1842
• [ruby] Update all Bundler dependencies (2024-12-26) by @depfu in #1843
• Ruby 3.4.1 by @jagthedrummer in #1847
• [js] Update Node.js 22.11.0 → 22.12.0 by @depfu in #1790
• [ruby] Update all Bundler dependencies (2024-12-30) by @depfu in #1844
• BT-Core version bump: - 1.14.0 by @jagthedrummer in #1848

Full Changelog: v1.13.0...v1.14.0

v1.13.0

Possible Breaking Change - Upgrade to Rails 8

Rails 8 includes the removal of some deprecated classes. This may cause problems if you have other gems that are relying on some of those classes.

For instance you may see an error like this:

LoadError: cannot load such file -- active_support/basic_object

or

LoadError: cannot load such file -- active_support/proxy_object

One gem that used to rely on those classes is jbuilder, so you might start by making sure it's up to date.

bundle update jbuilder --conservative

It's probably a good time to check for other gems that are out of date.

bundle outdated

Or you could just update everything.

bundle update

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-12-21) by @depfu in #1833
• [js] Update all Yarn dependencies (2024-12-21) by @depfu in #1834
• [js] Update all Yarn dependencies (2024-12-22) by @depfu in #1837
• [ruby] Update all Bundler dependencies (2024-12-22) by @depfu in #1836
• Set the stack in app.json by @jagthedrummer in #1832
• [ruby] Update all Bundler dependencies (2024-12-23) by @depfu in #1838
• Rails 8.0.1 by @jagthedrummer in #1824
• BT-Core version bump: - 1.13.0 by @jagthedrummer in #1839

Full Changelog: v1.12.3...v1.13.0

v1.12.3

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-12-19) by @depfu in #1826
• [js] Update all Yarn dependencies (2024-12-19) by @depfu in #1827
• [ruby] Update all Bundler dependencies (2024-12-20) by @depfu in #1828
• [js] Update all Yarn dependencies (2024-12-20) by @depfu in #1829
• Fix missing JS peer dependencies by @jagthedrummer in #1830
• Extract super scaffolding tests into smaller individual units by @jagthedrummer in #1825
• BT-Core version bump: - 1.12.3 by @jagthedrummer in #1831

Full Changelog: v1.12.2...v1.12.3

v1.12.2

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-12-17) by @depfu in #1818
• [js] Update all Yarn dependencies (2024-12-17) by @depfu in #1819
• [ruby] Update all Bundler dependencies (2024-12-18) by @depfu in #1822
• Rails 7.2 Defaults by @jagthedrummer in #1817
• Ability to super scaffold fields onto Membership by @jagthedrummer in #1821
• Add a checkbox field partial by @jagthedrummer in #1820
• BT-Core version bump: - 1.12.2 by @jagthedrummer in #1823

Full Changelog: v1.12.1...v1.12.2

v1.12.1

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• 🚨 [security] [ruby] Update rails 7.2.2 → 7.2.2.1 (minor) by @depfu in #1795
• [ruby] Update all Bundler dependencies (2024-12-11) by @depfu in #1796
• [js] Update all Yarn dependencies (2024-12-11) by @depfu in #1797
• [ruby] Update all Bundler dependencies (2024-12-12) by @depfu in #1799
• [js] Update all Yarn dependencies (2024-12-12) by @depfu in #1800
• [ruby] Update all Bundler dependencies (2024-12-13) by @depfu in #1803
• [ruby] Update all Bundler dependencies (2024-12-14) by @depfu in #1804
• [ruby] Update all Bundler dependencies (2024-12-15) by @depfu in #1806
• [js] Update all Yarn dependencies (2024-12-15) by @depfu in #1807
• [ruby] Update all Bundler dependencies (2024-12-16) by @depfu in #1811
• Improve Heroku Detection by @jagthedrummer in #1813
• Make turned off redis/pg non-breaking during setup by @RichStone in #1810
• Show how to run BT on Render for free by @RichStone in #1809
• Fix for standardrb in GitHub Actions by @jagthedrummer in #1814
• BT-Core version bump: - 1.12.1 by @jagthedrummer in #1815

Full Changelog: v1.12.0...v1.12.1

v1.12.0

Potentially Breaking Changes

This release contains a big set of updates to the CI workflows for GitHub Actions. If you've customized the workflows you may have some merge conflicts, or there may be things that don't quite work like they used to. If that's the case please open an issue and/or reach out on Discord if you'd like some help.

Likely Merge Conflict

You're likely to have a merge conflict in config/database.yml when you upgrade. It probably looks like this:

<<<<<<< HEAD
  database: your_app_test
||||||| f499f057
  database: untitled_application_test
=======
  database: untitled_application_test<%= ENV['TEST_ENV_NUMBER'] %>
  <% if ENV['CI'] %>username: <%= ENV['POSTGRES_USER'] %><% end %>
  <% if ENV['CI'] %>password: <%= ENV['POSTGRES_PASSWORD'] %><% end %>
  <% if ENV['CI'] %>host: localhost<% end %>
>>>>>>> v1.12.0

The best way to resolve this is to pick the entire bottom block, deleting the others:

  database: untitled_application_test<%= ENV['TEST_ENV_NUMBER'] %>
  <% if ENV['CI'] %>username: <%= ENV['POSTGRES_USER'] %><% end %>
  <% if ENV['CI'] %>password: <%= ENV['POSTGRES_PASSWORD'] %><% end %>
  <% if ENV['CI'] %>host: localhost<% end %>

Then update that first line to say your_app_test (using the naming convention for your app) instead of untitled_application_test:

  database: your_app_test<%= ENV['TEST_ENV_NUMBER'] %>
  <% if ENV['CI'] %>username: <%= ENV['POSTGRES_USER'] %><% end %>
  <% if ENV['CI'] %>password: <%= ENV['POSTGRES_PASSWORD'] %><% end %>
  <% if ENV['CI'] %>host: localhost<% end %>

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-11-26) by @depfu in #1783
• [js] Update all Yarn dependencies (2024-11-27) by @depfu in #1785
• [js] Update all Yarn dependencies (2024-12-01) by @depfu in #1788
• 🚨 [security] [ruby] Update rails-html-sanitizer 1.6.0 → 1.6.1 (patch) by @depfu in #1789
• [js] Update all Yarn dependencies (2024-12-05) by @depfu in #1791
• Improvements for CI in GitHub Actions by @jagthedrummer in #1787
• [ruby] Update all Bundler dependencies (2024-12-10) by @depfu in #1784
• BT-Core version bump: - 1.12.0 by @jagthedrummer in #1794

Full Changelog: v1.11.0...v1.12.0

v1.11.0

Potentially Breaking Changes

• Slimmer CSS for Mailers - We no longer include application.css in mailers. See the PR for more details and info about how to bring it back if you need it. bullet-train-co/bullet_train-core#969

• Dropped dependency on bullet_train-routes - This is a gem that had been included as a dependency of the main bullet_train gem, but it wasn't actually used by any of the core gems or by the starter repo. See the PR for info about how to add it to your project directly if you're using it. bullet-train-co/bullet_train-core#967

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-11-22) by @depfu in #1777
• [ruby] Update all Bundler dependencies (2024-11-23) by @depfu in #1779
• [js] Update all Yarn dependencies (2024-11-23) by @depfu in #1780
• BT-Core version bump: - 1.11.0 by @jagthedrummer in #1782

Full Changelog: v1.10.0...v1.11.0

v1.10.0

Potentially Breaking Changes

• We removed the password and implicit_grant flows from the default Doorkeeper config because they are kind of risky from a security standpoint. It's easy to add them back if you use them. See the PR for details: #1772

• When displaying boolean, date, and date_and_time attributes we now default to showing nothing if they are blank. Previously we'd show a label and nothing else for an empty boolean attribute, and for date/date_and_time we'd display the word "Never" without an associated label. See the PR for details: bullet-train-co/bullet_train-core#960

• Newly created Teams now default the time_zone to UTC if one is not specified. This should only come into play for Teams created outside the normal Bullet Train UI flows. See the PR for details: bullet-train-co/bullet_train-core#958

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-11-20) by @depfu in #1770
• [ruby] Update all Bundler dependencies (2024-11-21) by @depfu in #1775
• Clean up the CircleCI setup by @jagthedrummer in #1773
• Remove a couple of the riskier Doorkeeper grant flows by @jagthedrummer in #1772
• BT-Core version bump: - 1.10.0 by @jagthedrummer in #1776

Full Changelog: v1.9.0...v1.10.0

v1.9.0

Potentially Breaking Changes

pagy upgrade

This release upgrades the pagy gem from version 6 to version 8. In doing so the text for the "next page" and "previous page" buttons has changed from < Prev & Next > to < & >. This may break system tests if you have custom tests around pagination. See the PR for details about how to go back to the old text and/or how to update your pagination tests.

ruby upgrade

This release upgrades ruby to verison 3.3.6. You'll need to install it locally via whatever runtime manager you use (asdf is a good one if you're looking for recommendations) and then run bundle install to install all the gems for the new version. See the ruby upgrade PR for details on exactly what changed.

node upgrade

This release upgrades node to version 22.11.0. You'll need to install it locally via whatever runtime manager you use (asdf is a good one if you're looking for recommendations) and then do the following to install yarn and all the JS dependencies:

npm install -g yarn
corepack enable
yarn install

See the node upgrade PR for details on exactly what changed and for more context around the commands listed above.

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-11-19) by @depfu in #1768
• Upgrade pagy to version 8 (via core) by @jagthedrummer in #1767
• [ruby] Update Ruby 3.3.5 → 3.3.6 by @depfu in #1746
• [js] Update Node.js 20.18.0 → 22.11.0 by @depfu in #1734
• BT-Core version bump: - 1.9.0 by @jagthedrummer in #1769

Full Changelog: v1.8.5...v1.9.0

v1.8.5

What's changed in bullet_train-core

Also check the corresponding release for the bullet_train-core repo:
https://github.com/bullet-train-co/bullet_train-core/releases

What's Changed

• [ruby] Update all Bundler dependencies (2024-11-16) by @depfu in #1761
• [js] Update all Yarn dependencies (2024-11-16) by @depfu in #1762
• [js] Update all Yarn dependencies (2024-11-17) by @depfu in #1763
• Remove a monkey patch for ActionText::Content by @jagthedrummer in #1764
• Add script to check for image processing deps by @hopsoft in #1689
• Refactor check_image_dependencies.rb to not require both vips and ImageMagick by @jagthedrummer in #1765
• BT-Core version bump: - 1.8.5 by @jagthedrummer in #1766

New Contributors

• @hopsoft made their first contribution in #1689

Full Changelog: v1.8.4...v1.8.5