Modernize code & update dependencies.

Author: ioquatix

.github/workflows/documentation-coverage.yaml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ruby

.github/workflows/documentation.yaml

@@ -24,7 +24,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
 
     - uses: ruby/setup-ruby@v1
       with:
@@ -39,7 +39,7 @@ jobs:
       run: bundle exec bake utopia:project:static --force no
 
     - name: Upload documentation artifact
-      uses: actions/upload-pages-artifact@v3
+      uses: actions/upload-pages-artifact@v4
       with:
         path: docs
 

.github/workflows/rubocop.yaml

@@ -10,7 +10,7 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ruby

.github/workflows/test-coverage.yaml

@@ -23,7 +23,7 @@ jobs:
           - ruby
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{matrix.ruby}}
@@ -33,7 +33,7 @@ jobs:
       timeout-minutes: 5
       run: bundle exec bake test
 
-    - uses: actions/upload-artifact@v4
+    - uses: actions/upload-artifact@v5
       with:
         include-hidden-files: true
         if-no-files-found: error
@@ -45,13 +45,13 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ruby
         bundler-cache: true
 
-    - uses: actions/download-artifact@v4
+    - uses: actions/download-artifact@v6
 
     - name: Validate coverage
       timeout-minutes: 5

.github/workflows/test.yaml

@@ -18,9 +18,9 @@ jobs:
           - macos
 
         ruby:
-          - "3.2"
           - "3.3"
           - "3.4"
+          - "4.0"
 
         experimental: [false]
 
@@ -36,7 +36,7 @@ jobs:
             experimental: true
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - uses: ruby/setup-ruby@v1
       with:
         ruby-version: ${{matrix.ruby}}

.rubocop.yml

@@ -1,12 +1,23 @@
 plugins:
+  - rubocop-md
   - rubocop-socketry
 
 AllCops:
   DisabledByDefault: true
 
+# Socketry specific rules:
+
 Layout/ConsistentBlankLineIndentation:
   Enabled: true
 
+Layout/BlockDelimiterSpacing:
+  Enabled: true
+
+Style/GlobalExceptionVariables:
+  Enabled: true
+
+# General Layout rules:
+
 Layout/IndentationStyle:
   Enabled: true
   EnforcedStyle: tabs
@@ -33,6 +44,9 @@ Layout/BeginEndAlignment:
   Enabled: true
   EnforcedStyleAlignWith: start_of_line
 
+Layout/RescueEnsureAlignment:
+  Enabled: true
+
 Layout/ElseAlignment:
   Enabled: true
 
@@ -41,10 +55,15 @@ Layout/DefEndAlignment:
 
 Layout/CaseIndentation:
   Enabled: true
+  EnforcedStyle: end
 
 Layout/CommentIndentation:
   Enabled: true
 
+Layout/FirstHashElementIndentation:
+  Enabled: true
+  EnforcedStyle: consistent
+
 Layout/EmptyLinesAroundClassBody:
   Enabled: true
 
@@ -63,6 +82,25 @@ Layout/SpaceAroundBlockParameters:
   Enabled: true
   EnforcedStyleInsidePipes: no_space
 
+Layout/FirstArrayElementIndentation:
+  Enabled: true
+  EnforcedStyle: consistent
+
+Layout/ArrayAlignment:
+  Enabled: true
+  EnforcedStyle: with_fixed_indentation
+
+Layout/FirstArgumentIndentation:
+  Enabled: true
+  EnforcedStyle: consistent
+
+Layout/ArgumentAlignment:
+  Enabled: true
+  EnforcedStyle: with_fixed_indentation
+
+Layout/ClosingParenthesisIndentation:
+  Enabled: true
+
 Style/FrozenStringLiteralComment:
   Enabled: true
 

bake.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 # Update the project documentation with the new version number.
 #
@@ -10,3 +10,10 @@ def after_gem_release_version_increment(version)
 	context["releases:update"].call(version)
 	context["utopia:project:update"].call
 end
+
+# Create a GitHub release for the given tag.
+#
+# @parameter tag [String] The tag to create a release for.
+def after_gem_release(tag:, **options)
+	context["releases:github:release"].call(tag)
+end

config/sus.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+# Released under the MIT License.
+# Copyright, 2025-2026, by Samuel Williams.
+
 require "covered/sus"
 include Covered::Sus
 

context/flappy-bird-tutorial.md

@@ -48,7 +48,7 @@ First, let's create the basic structure for our game. We'll start with a simple
 Create a new file called `flappy_basic.rb`:
 
 ```ruby
-require 'live'
+require "live"
 
 class FlappyBasicView < Live::View
 	WIDTH = 420
@@ -172,7 +172,7 @@ class Bird < BoundingBox
 
 	def initialize(x = 30, y = HEIGHT / 2, width: 34, height: 24, skin: nil)
 		super(x, y, width, height)
-		@skin = skin || 'bird'
+		@skin = skin || "bird"
 		@velocity = 0.0
 		@jumping = false
 		@dying = false
@@ -253,7 +253,7 @@ class Bird < BoundingBox
 
 				builder.inline_tag(:div, 
 					id: id, 
-					class: 'particle jump', 
+					class: "particle jump", 
 					style: "left: #{center[0]}px; bottom: #{center[1]}px; --rotation-angle: #{angle}deg;"
 				)
 			end
@@ -387,12 +387,12 @@ class Pipe
 
 		# Render lower pipe
 		builder.inline_tag(:div, 
-			class: 'pipe', 
+			class: "pipe", 
 			style: "left: #{@x}px; bottom: #{self.bottom}px; width: #{@width}px; height: #{@height}px; #{display}"
 		)
 		# Render upper pipe
 		builder.inline_tag(:div, 
-			class: 'pipe', 
+			class: "pipe", 
 			style: "left: #{@x}px; bottom: #{self.top}px; width: #{@width}px; height: #{@height}px; #{display}"
 		)
 	end
@@ -461,7 +461,7 @@ class Gemstone < BoundingBox
 		end
 
 		builder.inline_tag(:div, 
-			class: 'gemstone', 
+			class: "gemstone", 
 			style: "left: #{@x}px; bottom: #{@y}px; width: #{@width}px; height: #{@height}px; opacity: #{opacity};"
 		)
 
@@ -475,7 +475,7 @@ class Gemstone < BoundingBox
 
 				builder.inline_tag(:div, 
 					id: id, 
-					class: 'particle bonus', 
+					class: "particle bonus", 
 					style: "left: #{center[0]}px; bottom: #{center[1]}px; --rotation-angle: #{angle}deg;"
 				)
 			end
@@ -540,7 +540,7 @@ Let's add a way for players to choose different bird skins:
 
 ```ruby
 class SkinSelectionView < Live::View
-	SKINS = ['bird', 'gull', 'kiwi', 'owl']
+	SKINS = ["bird", "gull", "kiwi", "owl"]
 
 	def handle(event)
 		skin = event.dig(:detail, :skin) or return
@@ -627,7 +627,7 @@ class FlappyView < Live::View
 		@pipes = nil
 		@bonus = nil
 
-		@skin_selection = SkinSelectionView.mount(self, 'skin-selection')
+		@skin_selection = SkinSelectionView.mount(self, "skin-selection")
 
 		# Game state
 		@score = 0
@@ -784,7 +784,7 @@ def step(dt)
 					play_music
 				end
 			end
-		
+			
 			# Check for collision
 			if pipe.intersect?(@bird)
 				Console.info(self, "Player has died.")
@@ -943,7 +943,7 @@ Here's how all the pieces fit together in a complete game file:
 #!/usr/bin/env lively
 # frozen_string_literal: true
 
-require 'live'
+require "live"
 
 # [All the classes we've built: BoundingBox, Bird, Pipe, Gemstone, SkinSelectionView, FlappyView]
 # Put them all together in a single file for easy execution

context/game-audio-tutorial.md

@@ -116,7 +116,7 @@ To play sounds from your Ruby application, you need to connect your custom eleme
 **Ruby Application (`application.rb`):**
 
 ```ruby
-require 'lively'
+require "lively"
 
 class GameView < Live::View
 	def tag_name
@@ -131,17 +131,17 @@ class GameView < Live::View
 
 	def player_jump
 		@player.jump
-		play_sound('jump')   # Play jump sound
+		play_sound("jump")   # Play jump sound
 	end
 
 	def collect_coin
 		@score += 10
-		play_sound('coin')   # Play coin sound
+		play_sound("coin")   # Play coin sound
 	end
 
 	def player_dies
 		@lives -= 1
-		play_sound('death')  # Play death sound
+		play_sound("death")  # Play death sound
 	end
 end
 ```