Generate Falcon serve configuration.

Assisted-By: devx/b3414b50-d642-461b-95a8-8f773c4d087b

Author: samuel-williams-shopify

bake/utopia/site.rb

@@ -18,7 +18,7 @@ def initialize(...)
 SETUP_ROOT = File.expand_path("../../setup", __dir__)
 
 # Configuration files which should be installed/updated:
-CONFIGURATION_FILES = [".gitignore", "config/application.rb", "config/environment.rb", "falcon.rb", "gems.rb", "bake.rb", "test/website.rb", "fixtures/website.rb"]
+CONFIGURATION_FILES = [".gitignore", "config/application.rb", "config/environment.rb", "config/serve.rb", "falcon.rb", "gems.rb", "bake.rb", "test/website.rb", "fixtures/website.rb"]
 
 # Directories that should exist:
 DIRECTORIES = ["config", "lib", "pages", "public", "bake", "fixtures", "test"]

gems.rb

@@ -31,7 +31,7 @@
 	gem "rubocop-md"
 	gem "rubocop-socketry"
 
-	gem "falcon"
+	gem "falcon", "~> 0.57"
 	gem "async-websocket"
 	gem "sus-fixtures-async-http"
 

setup/site/config/serve.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2026, by Samuel Williams.
+
+require "utopia/application"
+
+run Utopia::Application.load(File.expand_path("application.rb", __dir__))

setup/site/gems.rb

@@ -27,5 +27,5 @@
 end
 
 group :production do
-	gem "falcon"
+	gem "falcon", "~> 0.57"
 end

test/utopia/application.rb

@@ -136,4 +136,17 @@ def initialize(message:)
 			expect(response.status).to be == 404
 		end
 	end
+	
+	it "loads the generated serve configuration" do
+		path = File.expand_path("../../setup/site/config/serve.rb", __dir__)
+		application = Protocol::HTTP::Middleware.load(path)
+		response = application.call(Protocol::HTTP::Request["GET", "/"])
+		
+		expect(application).to be_a(Utopia::Application)
+		expect(response.status).to be == 301
+		expect(response.headers["location"]).to be == "/welcome/index"
+	ensure
+		response&.close
+		application&.close
+	end
 end

test/utopia/command.rb

@@ -57,6 +57,8 @@ def install_packages(dir)
 			expect(site_files).to be(:include?, file)
 		end
 
+		expect(File.file?(File.join(root, "config/serve.rb"))).to be == true
+		
 		expect(
 			system("bundle", "exec", "bake", "test", chdir: root)
 		).to be == true