1 files changed, 59 insertions, 25 deletions

diff --git a/Gemfile b/Gemfile
index 2bb3333..13bb4ca 100644
--- a/Gemfile
+++ b/Gemfile
@@ -2,40 +2,74 @@ source 'https://rubygems.org'
 
 ruby '3.2.11'
 
-gem 'rails', '~> 7.2.3'
+# ── Core framework ────────────────────────────────────────────────────────────
+
+gem 'rails',      '~> 8.1'
+gem 'rails-i18n', '~> 8.0'  # AR error messages and date formats for :de locale
+
+# concurrent-ruby 1.3 ships with Rails 8 but has a known incompatibility with
+# some versions of Zeitwerk unless pinned. Remove once upstream resolves it.
 gem 'concurrent-ruby', '~> 1.3'
-gem 'sprockets-rails'
-gem 'puma'
+
+gem 'puma'               # default Rails 8 server; used in development only
+gem 'unicorn', '~> 6.1'  # production server (FreeBSD jail, managed via rc.d)
+
+# ── Database ──────────────────────────────────────────────────────────────────
 
 gem 'pg', '~> 1.5'
 
-gem 'acts-as-taggable-on', '~> 12.0'
-gem 'awesome_nested_set', '~> 3.7.0'
-gem 'acts_as_list'
-gem 'globalize', '~> 7.0'
-gem 'routing-filter', '~> 0.7.0'
-gem 'will_paginate', '~> 3.0'
-gem 'exception_notification', '~> 4.5'
-gem 'libxml-ruby', '~> 5.0', :require => 'xml'
+# ── Asset pipeline ────────────────────────────────────────────────────────────
+
+gem 'sprockets-rails'
+gem 'sass-rails',   '~> 6.0'
+gem 'coffee-rails', '~> 4.0'
+gem 'uglifier',     '>= 1.0.3'
 
-gem 'jquery-rails'
-gem 'jquery-ui-rails'
+gem 'jquery-rails'     # provides jQuery via asset pipeline (admin only)
+gem 'jquery-ui-rails'  # provides jQuery UI via asset pipeline (admin only)
 
-gem 'nokogiri', '~> 1.18'
+# TinyMCE 8 via asset pipeline; replaces vendored TinyMCE 3 in public/javascripts.
+# Note: TinyMCE 7+ is GPL-licensed.
+gem 'tinymce-rails', '~> 8.3'
 
-gem 'unicorn', '~> 6.1'
+# ── Model layer ───────────────────────────────────────────────────────────────
 
-group :assets do
-  gem 'sass-rails', '~> 6.0'
-  gem 'coffee-rails', '~> 4.0'
-  gem 'uglifier', '>= 1.0.3'
-end
+gem 'globalize',      '~> 7.0'    # translated model attributes (Page title/abstract/body)
+gem 'acts_as_list'                # page revision ordering
+gem 'will_paginate',  '~> 3.0'
+
+# Pinned to git until a release widens the activerecord < 8.1 ceiling.
+# Both gems work correctly on Rails 8.1; the gemspec constraint is overly conservative.
+# Revisit when acts-as-taggable-on > 12.x or awesome_nested_set > 3.8.0 is released.
+gem 'acts-as-taggable-on',
+    git:    'https://github.com/mbleigh/acts-as-taggable-on.git',
+    branch: 'master'
+gem 'awesome_nested_set',
+    git:    'https://github.com/collectiveidea/awesome_nested_set.git',
+    branch: 'main'
+
+# ── XML / parsing ─────────────────────────────────────────────────────────────
+
+gem 'libxml-ruby', '~> 5.0', require: 'xml'  # body link rewriting in Page model
+gem 'nokogiri',    '~> 1.18'
+
+# ── Operational ───────────────────────────────────────────────────────────────
+
+gem 'exception_notification', '~> 4.5'
+
+# chaos_calendar: C extension wrapping libical for the public events calendar.
+# Pinned to custom branch; includes FreeBSD 15.1 / libical 3.x header path fix
+# and icaltime_from_timet_with_zone floating-time semantics.
+gem 'chaos_calendar',
+    git:     'https://github.com/erdgeist/chaoscalendar.git',
+    branch:  'erdgeist-ruby1.9',
+    require: 'chaos_calendar'
+
+# ── Test ──────────────────────────────────────────────────────────────────────
 
 group :test do
-  gem 'test-unit', '~> 3.5'
+  gem 'test-unit',              '~> 3.5'
   gem 'rails-controller-testing'
-  gem 'minitest', '~> 5.25'
+  # minitest ~> 5.25 required; 6.x breaks the Rails 8 test runner.
+  gem 'minitest',               '~> 5.25'
 end
-
-gem 'chaos_calendar', :git => 'https://github.com/erdgeist/chaoscalendar.git',
-    :require => 'chaos_calendar', :branch => 'erdgeist-ruby1.9'