bridgetown-core 1.2.0 → 1.3.0.beta2

data/lib/bridgetown-core/errors.rb

@@ -15,10 +15,13 @@ module Bridgetown
     InvalidURLError             = Class.new(FatalException)
     InvalidConfigurationError   = Class.new(FatalException)
 
-    def self.print_build_error(exc, trace: false, logger: Bridgetown.logger)
+    def self.print_build_error(exc, trace: false, logger: Bridgetown.logger, server: false) # rubocop:disable Metrics
       logger.error "Exception raised:", exc.class.to_s.bold
       logger.error exc.message.reset_ansi
 
+      build_errors_file = Bridgetown.build_errors_path if !server && Bridgetown::Current.site
+      build_errors_data = "#{exc.class}: #{exc.message}"
+
       trace_args = ["-t", "--trace"]
       print_trace_msg = true
       traces = if trace || ARGV.find { |arg| trace_args.include?(arg) }
@@ -29,6 +32,12 @@ module Bridgetown
                end
       traces.each_with_index do |backtrace_line, index|
         logger.error "#{index + 1}:", backtrace_line.reset_ansi
+        build_errors_data << "\n#{backtrace_line}" if index < 2
+      end
+
+      if build_errors_file
+        FileUtils.mkdir_p(File.dirname(build_errors_file))
+        File.write(build_errors_file, build_errors_data, mode: "w")
       end
 
       return unless print_trace_msg

data/lib/bridgetown-core/filters/localization_filters.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Bridgetown
+  module Filters
+    module LocalizationFilters
+      def l(input)
+        I18n.l(input.to_s)
+      end
+    end
+  end
+end

data/lib/bridgetown-core/helpers.rb

@@ -135,6 +135,14 @@ module Bridgetown
         I18n.send :t, *args, **kwargs
       end
 
+      # Forward all arguments to I18n.l method
+      #
+      # @return [String] the localized string
+      # @see I18n
+      def l(*args, **kwargs)
+        I18n.send :l, *args, **kwargs
+      end
+
       # For template contexts where ActiveSupport's output safety is loaded, we
       # can ensure a string has been marked safe
       #
@@ -221,6 +229,32 @@ module Bridgetown
         end
       end
 
+      def dsd(input = nil, &block)
+        tmpl_content = block.nil? ? input.to_s : view.capture(&block)
+
+        Bridgetown::Utils.dsd_tag(tmpl_content)
+      end
+
+      def dsd_style
+        tmpl_path = caller_locations(1, 2).find do |loc|
+                      loc.label.include?("method_missing").!
+                    end&.path
+
+        return unless tmpl_path # virtually guaranteed not to happen
+
+        tmpl_basename = File.basename(tmpl_path, ".*")
+        style_path = File.join(File.dirname(tmpl_path), "#{tmpl_basename}.dsd.css")
+
+        unless File.file?(style_path)
+          raise Bridgetown::Errors::FatalException, "Missing stylesheet at #{style_path}"
+        end
+
+        style_tag = site.tmp_cache["dsd_style:#{style_path}"] ||=
+          "<style>#{File.read(style_path)}</style>"
+
+        style_tag.html_safe
+      end
+
       private
 
       # Covert an underscored value into a dashed string.

data/lib/bridgetown-core/plugin_manager.rb

@@ -206,30 +206,6 @@ module Bridgetown
         sorted_plugin_files.each do |plugin_file|
           self.class.add_registered_plugin plugin_file
         end
-        next if site.config[:plugins_use_zeitwerk]
-
-        Deprecator.deprecation_message(
-          "The `plugins_use_zeitwerk' configuration option will be removed in the next version " \
-          "of Bridgetown (aka will be permanently set to \"true\")"
-        )
-        Bridgetown::Utils::RequireGems.require_with_graceful_fail(sorted_plugin_files)
-      end
-    end
-
-    # Reloads .rb plugin files via the watcher
-    # DEPRECATED (not necessary with Zeitwerk)
-    #
-    # @return [void]
-    def reload_plugin_files
-      return if site.config[:plugins_use_zeitwerk]
-
-      plugins_path.each do |plugin_search_path|
-        plugin_files = Utils.safe_glob(plugin_search_path, File.join("**", "*.rb"))
-        Array(plugin_files).each do |name|
-          Bridgetown.logger.debug "Reloading:", name.to_s
-          self.class.add_registered_plugin name
-          load name
-        end
       end
     end
 

data/lib/bridgetown-core/rack/boot.rb

@@ -8,12 +8,22 @@ require "roda/plugins/public"
 Bridgetown::Current.preloaded_configuration ||= Bridgetown.configuration
 
 require_relative "logger"
-require_relative "roda"
 require_relative "routes"
 require_relative "static_indexes"
 
 module Bridgetown
   module Rack
+    class Roda < ::Roda
+      def self.inherited(klass)
+        Bridgetown::Deprecator.deprecation_message(
+          "The `Bridgetown::Rack::Roda' class will be removed in favor of using the " \
+          "`bridgetown_server' plugin in a future version"
+        )
+        super
+        klass.plugin :bridgetown_server
+      end
+    end
+
     class << self
       # @return [Bridgetown::Utils::LoadersManager]
       attr_accessor :loaders_manager
@@ -56,6 +66,8 @@ module Bridgetown
             loader.reload
             loader.eager_load
             Bridgetown::Rack::Routes.reload_subclasses
+          rescue SyntaxError => e
+            Bridgetown::Errors.print_build_error(e)
           end.start
         end
       end

data/lib/bridgetown-core/rack/routes.rb

@@ -20,6 +20,37 @@ module Bridgetown
       }.freeze
 
       class << self
+        # rubocop:disable Bridgetown/NoPutsAllowed, Metrics/MethodLength
+        def print_routes
+          # TODO: this needs to be fully documented
+          routes = begin
+            JSON.parse(
+              File.read(
+                File.join(Bridgetown::Current.preloaded_configuration.root_dir, ".routes.json")
+              )
+            )
+          rescue StandardError
+            []
+          end
+          puts
+          puts "Routes:"
+          puts "======="
+          if routes.blank?
+            puts "No routes found. Have you commented all of your routes?"
+            puts "Documentation: https://github.com/jeremyevans/roda-route_list#basic-usage-"
+          end
+
+          routes.each do |route|
+            puts [
+              route["methods"]&.join("|") || "GET",
+              route["path"],
+              route["file"] ? "\n  File: #{route["file"]}" : nil,
+            ].compact.join(" ")
+          end
+          puts
+        end
+        # rubocop:enable Bridgetown/NoPutsAllowed, Metrics/MethodLength
+
         # @return [Hash<String, Class(Routes)>]
         attr_accessor :tracked_subclasses
 
@@ -80,7 +111,7 @@ module Bridgetown
         # Initialize a new Routes instance and execute the route as part of the
         # Roda app request cycle
         #
-        # @param roda_app [Bridgetown::Rack::Roda]
+        # @param roda_app [Roda]
         def merge(roda_app)
           return unless router_block
 
@@ -90,7 +121,7 @@ module Bridgetown
         # Start the Roda app request cycle. There are two different code paths
         # depending on if there's a site `base_path` configured
         #
-        # @param roda_app [Bridgetown::Rack::Roda]
+        # @param roda_app [Roda]
         # @return [void]
         def start!(roda_app)
           if Bridgetown::Current.preloaded_configuration.base_path == "/"
@@ -112,7 +143,7 @@ module Bridgetown
         # run through all the Routes blocks. If the file-based router plugin
         # is available, kick off that request process next.
         #
-        # @param roda_app [Bridgetown::Rack::Roda]
+        # @param roda_app [Roda]
         # @return [void]
         def load_all_routes(roda_app)
           roda_app.request.public
@@ -127,11 +158,12 @@ module Bridgetown
           end
         end
 
-        # @param app [Bridgetown::Rack::Roda]
-        def setup_live_reload(app) # rubocop:disable Metrics/AbcSize
+        # @param app [Roda]
+        def setup_live_reload(app) # rubocop:disable Metrics
           sleep_interval = 0.2
           file_to_check = File.join(Bridgetown::Current.preloaded_configuration.destination,
                                     "index.html")
+          errors_file = Bridgetown.build_errors_path
 
           app.request.get "_bridgetown/live_reload" do
             app.response["Content-Type"] = "text/event-stream"
@@ -146,6 +178,8 @@ module Bridgetown
                 if @_mod < new_mod
                   out << "data: reloaded!\n\n"
                   break
+                elsif File.exist?(errors_file)
+                  out << "event: builderror\ndata: #{File.read(errors_file).to_json}\n\n"
                 else
                   out << "data: #{new_mod}\n\n"
                 end
@@ -157,7 +191,7 @@ module Bridgetown
         end
       end
 
-      # @param roda_app [Bridgetown::Rack::Roda]
+      # @param roda_app [Roda]
       def initialize(roda_app)
         @_roda_app = roda_app
       end

data/lib/bridgetown-core/readers/layout_reader.rb

@@ -11,13 +11,13 @@ module Bridgetown
 
     def read
       layout_entries.each do |layout_file|
-        @layouts[layout_name(layout_file)] = \
+        @layouts[layout_name(layout_file)] =
           Layout.new(site, layout_directory, layout_file)
       end
 
       site.config.source_manifests.filter_map(&:layouts).each do |plugin_layouts|
         layout_entries(plugin_layouts).each do |layout_file|
-          @layouts[layout_name(layout_file)] ||= \
+          @layouts[layout_name(layout_file)] ||=
             Layout.new(site, plugin_layouts, layout_file, from_plugin: true)
         end
       end

data/lib/bridgetown-core/tags/dsd.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Bridgetown
+  module Tags
+    class DSDTag < Liquid::Block
+      def render(_context)
+        template_content = super
+
+        Bridgetown::Utils.dsd_tag(template_content)
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag("dsd", Bridgetown::Tags::DSDTag)

data/lib/bridgetown-core/tags/l.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Bridgetown
+  module Tags
+    class LocalizationTag < Liquid::Tag
+      def render(_context)
+        key = @markup.strip
+        I18n.l(key)
+      end
+    end
+  end
+end
+
+Liquid::Template.register_tag("l", Bridgetown::Tags::LocalizationTag)

data/lib/bridgetown-core/utils/aux.rb

@@ -29,6 +29,8 @@ module Bridgetown
           loop do
             line = rd.gets
             line.to_s.lines.map(&:chomp).each do |message|
+              next if name == "Frontend" && %r{ELIFECYCLE.*?Command failed}.match?(message)
+
               output = +""
               output << with_color(color, "[#{name}] ") if color
               output << message

data/lib/bridgetown-core/utils/loaders_manager.rb

@@ -13,6 +13,8 @@ module Bridgetown
         @config = config
         @loaders = {}
         @root_dir = config.root_dir
+
+        FileUtils.rm_f(Bridgetown.build_errors_path)
       end
 
       def unload_loaders
@@ -60,6 +62,9 @@ module Bridgetown
           end
           loader.enable_reloading if reloading_enabled?(load_path)
           loader.ignore(File.join(load_path, "**", "*.js.rb"))
+          loader.ignore(
+            File.join(File.expand_path(config[:islands_dir], config[:source]), "routes")
+          )
           config.autoloader_collapsed_paths.each do |collapsed_path|
             next unless collapsed_path.starts_with?(load_path)
 
@@ -75,6 +80,8 @@ module Bridgetown
       end
 
       def reload_loaders
+        FileUtils.rm_f(Bridgetown.build_errors_path)
+
         @loaders.each do |load_path, loader|
           next unless reloading_enabled?(load_path)
 

data/lib/bridgetown-core/utils.rb

@@ -412,7 +412,7 @@ module Bridgetown
                      end&.last
                    end
 
-      return log_frontend_asset_error(site, asset_type) if asset_path.nil?
+      return log_frontend_asset_error(site, "`#{asset_type}' asset") if asset_path.nil?
 
       static_frontend_path site, [asset_path]
     end
@@ -429,14 +429,16 @@ module Bridgetown
 
     def log_frontend_asset_error(site, asset_type)
       site.data[:__frontend_asset_errors] ||= {}
-      site.data[:__frontend_asset_errors][asset_type] ||=
+      site.data[:__frontend_asset_errors][asset_type] ||= begin
+        Bridgetown.logger.warn("#{frontend_bundler_type}:", "The #{asset_type} could not be found.")
         Bridgetown.logger.warn(
           "#{frontend_bundler_type}:",
-          "There was an error parsing your #{asset_type} file. \
-          Please check your #{asset_type} file for any errors."
+          "Double-check your frontend config or re-run `bin/bridgetown frontend:build'"
         )
+        true
+      end
 
-      "MISSING_#{frontend_bundler_type.upcase}_MANIFEST_FILE"
+      "MISSING_#{frontend_bundler_type.upcase}_ASSET"
     end
 
     def frontend_bundler_type(cwd = Dir.pwd)
@@ -449,6 +451,27 @@ module Bridgetown
       end
     end
 
+    def update_esbuild_autogenerated_config(config)
+      defaults_file = File.join(config[:root_dir], "config", "esbuild.defaults.js")
+      return unless File.exist?(defaults_file)
+
+      config_hash = {
+        source: Pathname.new(config[:source]).relative_path_from(config[:root_dir]),
+        destination: Pathname.new(config[:destination]).relative_path_from(config[:root_dir]),
+        componentsDir: config[:components_dir],
+        islandsDir: config[:islands_dir],
+      }
+
+      defaults_file_contents = File.read(defaults_file)
+      File.write(
+        defaults_file,
+        defaults_file_contents.sub(
+          %r{(const autogeneratedBridgetownConfig = ){\n.*?}}m,
+          "\\1#{JSON.pretty_generate config_hash}"
+        )
+      )
+    end
+
     def default_github_branch_name(repo_url)
       repo_match = Bridgetown::Commands::Actions::GITHUB_REPO_REGEX.match(repo_url)
       api_endpoint = "https://api.github.com/repos/#{repo_match[1]}"
@@ -466,6 +489,7 @@ module Bridgetown
         function startReloadConnection() {
           const evtSource = new EventSource("#{site.base_path(strip_slash_only: true)}/_bridgetown/live_reload")
           evtSource.onmessage = event => {
+            if (document.querySelector("#bridgetown-build-error")) document.querySelector("#bridgetown-build-error").close()
             if (event.data == "reloaded!") {
               location.reload()
             } else {
@@ -477,6 +501,23 @@ module Bridgetown
               }
             }
           }
+          evtSource.addEventListener("builderror", event => {
+            let dialog = document.querySelector("#bridgetown-build-error")
+            if (!dialog) {
+              dialog = document.createElement("dialog")
+              dialog.id = "bridgetown-build-error"
+              dialog.style.borderColor = "red"
+              dialog.style.fontSize = "110%"
+              dialog.innerHTML = `
+                <p style="color:red">There was an error when building the site:</p>
+                <output><pre></pre></output>
+                <p><small>Check your Bridgetown logs for further details.</small></p>
+              `
+              document.body.appendChild(dialog)
+              dialog.showModal()
+            }
+            dialog.querySelector("pre").textContent = JSON.parse(event.data)
+          })
           evtSource.onerror = event => {
             if (evtSource.readyState === 2) {
               // reconnect with new object
@@ -505,6 +546,12 @@ module Bridgetown
       end
     end
 
+    def dsd_tag(input, shadow_root_mode: :open)
+      raise ArgumentError unless [:open, :closed].include? shadow_root_mode
+
+      %(<template shadowrootmode="#{shadow_root_mode}">#{input}</template>).html_safe
+    end
+
     private
 
     def merge_values(target, overwrite)

data/lib/bridgetown-core/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module Bridgetown
-  VERSION = "1.2.0"
-  CODE_NAME = "Bonny Slope"
+  VERSION = "1.3.0.beta2"
+  CODE_NAME = "Kelly Butte"
 end

data/lib/bridgetown-core/watcher.rb

@@ -55,7 +55,7 @@ module Bridgetown
     # Start a listener to watch for changes and call {#reload_site}
     #
     # @param (see #watch)
-    def listen(site, options)
+    def listen(site, options) # rubocop:disable Metrics/MethodLength
       bundling_path = site.frontend_bundling_path
       FileUtils.mkdir_p(bundling_path)
       Listen.to(
@@ -66,12 +66,17 @@ module Bridgetown
         force_polling: options["force_polling"]
       ) do |modified, added, removed|
         c = modified + added + removed
+
+        # NOTE: inexplicably, this matcher doesn't work with the Listen gem, so
+        # we have to run it here manually
+        c.reject! { component_frontend_matcher(options).match? _1 }
         n = c.length
+        next if n.zero?
 
         unless site.ssr?
           Bridgetown.logger.info(
             "Reloading…",
-            "#{n} file#{"s" if c.length > 1} changed at #{Time.now.strftime("%Y-%m-%d %H:%M:%S")}"
+            "#{n} file#{"s" if n > 1} changed at #{Time.now.strftime("%Y-%m-%d %H:%M:%S")}"
           )
           c.each { |path| Bridgetown.logger.info "", "- #{path["#{site.root_dir}/".length..]}" }
         end
@@ -93,7 +98,6 @@ module Bridgetown
         catch :halt do
           Bridgetown::Hooks.trigger :site, :pre_reload, site, paths
           Bridgetown::Hooks.clear_reloadable_hooks
-          site.plugin_manager.reload_plugin_files
           site.loaders_manager.reload_loaders
           Bridgetown::Hooks.trigger :site, :post_reload, site, paths
 
@@ -106,7 +110,7 @@ module Bridgetown
         end
         Bridgetown.logger.info "Done! 🎉", "#{"Completed".bold.green} in less than " \
                                           "#{(Time.now - time).ceil(2)} seconds."
-      rescue StandardError => e
+      rescue StandardError, SyntaxError => e
         Bridgetown::Errors.print_build_error(e, trace: options[:trace])
       end
       Bridgetown.logger.info ""
@@ -124,12 +128,15 @@ module Bridgetown
     end
 
     def custom_excludes(options)
-      Array(options["exclude"]).map { |e| Bridgetown.sanitized_path(options["source"], e) }
+      Array(options["exclude"]).map { |e| Bridgetown.sanitized_path(options["root_dir"], e) }
     end
 
-    def component_frontend_matcher
-      %r{_components/.*?(\.js|\.jsx|\.js\.rb|\.css)$}
+    # rubocop:disable Layout/LineLength
+    def component_frontend_matcher(options)
+      @fematcher ||=
+        %r{(#{options[:components_dir]}|#{options[:islands_dir]})/(?:[^.]+|\.(?!dsd))+(\.js|\.jsx|\.js\.rb|\.css)$}
     end
+    # rubocop:enable Layout/LineLength
 
     def to_exclude(options)
       [
@@ -162,7 +169,7 @@ module Bridgetown
         rescue ArgumentError
           # Could not find a relative path
         end
-      end + [component_frontend_matcher] + [%r!^\.bridgetown-metadata!]
+      end
     end
 
     def sleep_forever

data/lib/bridgetown-core.rb

@@ -377,6 +377,18 @@ module Bridgetown
         File.join(base_directory, clean_path)
       end
     end
+
+    # When there's a build error, error details will be logged to a file which the dev server
+    #   can read and pass along to the browser.
+    #
+    # @return [String] the path to the cached errors file
+    def build_errors_path
+      File.join(
+        (Bridgetown::Current.site&.config || Bridgetown::Current.preloaded_configuration).root_dir,
+        ".bridgetown-cache",
+        "build_errors.txt"
+      )
+    end
   end
 end
 

data/lib/roda/plugins/bridgetown_server.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+class Roda
+  module RodaPlugins
+    module BridgetownServer
+      SiteContext = Struct.new(:registers) # for use by Liquid-esque URL helpers
+
+      def self.load_dependencies(app) # rubocop:disable Metrics
+        unless Bridgetown::Current.preloaded_configuration
+          raise "You must supply a preloaded configuration before loading the Bridgetown Roda " \
+                "plugin"
+        end
+
+        app.plugin :initializers
+        app.plugin :method_override
+        app.plugin :all_verbs
+        app.plugin :hooks
+        app.plugin :common_logger, Bridgetown::Rack::Logger.new($stdout), method: :info
+        app.plugin :json
+        app.plugin :json_parser
+        app.plugin :indifferent_params
+        app.plugin :cookies
+        app.plugin :streaming
+        app.plugin :public, root: Bridgetown::Current.preloaded_configuration.destination
+        app.plugin :not_found do
+          output_folder = Bridgetown::Current.preloaded_configuration.destination
+          File.read(File.join(output_folder, "404.html"))
+        rescue Errno::ENOENT
+          "404 Not Found"
+        end
+        app.plugin :exception_page
+        app.plugin :error_handler do |e|
+          Bridgetown::Errors.print_build_error(
+            e, logger: Bridgetown::LogAdapter.new(self.class.opts[:common_logger]), server: true
+          )
+          next exception_page(e) if ENV.fetch("RACK_ENV", nil) == "development"
+
+          output_folder = Bridgetown::Current.preloaded_configuration.destination
+          File.read(File.join(output_folder, "500.html"))
+        rescue Errno::ENOENT
+          "500 Internal Server Error"
+        end
+
+        ExceptionPage.class_eval do # rubocop:disable Metrics/BlockLength
+          def self.css
+            <<~CSS
+              html * { padding:0; margin:0; }
+              body * { padding:10px 20px; }
+              body * * { padding:0; }
+              body { font-family: -apple-system, sans-serif; font-size: 90%; }
+              body>div { border-bottom:1px solid #ddd; }
+              code { font-family: ui-monospace, monospace; }
+              h1 { font-weight: bold; margin-block-end: .8em; }
+              h2 { margin-block-end:.8em; }
+              h2 span { font-size:80%; color:#f7f7db; font-weight:normal; }
+              h3 { margin:1em 0 .5em 0; }
+              h4 { margin:0 0 .5em 0; font-weight: normal; }
+              table {
+                  border:1px solid #ccc; border-collapse: collapse; background:white; }
+              tbody td, tbody th { vertical-align:top; padding:2px 3px; }
+              thead th {
+                  padding:1px 6px 1px 3px; background:#fefefe; text-align:left;
+                  font-weight:normal; font-size:11px; border:1px solid #ddd; }
+              tbody th { text-align:right; opacity: 0.7; padding-right:.5em; }
+              table.vars { margin:5px 0 2px 40px; }
+              table.vars td, table.req td { font-family: ui-monospace, monospace; }
+              table td.code { width:100%;}
+              table td.code div { overflow:hidden; }
+              table.source th { color:#666; }
+              table.source td {
+                  font-family: ui-monospace, monospace; white-space:pre; border-bottom:1px solid #eee; }
+              ul.traceback { list-style-type:none; }
+              ul.traceback li.frame { margin-bottom:1em; }
+              div.context { margin: 10px 0; }
+              div.context ol {
+                  padding-left:30px; margin:0 10px; list-style-position: inside; }
+              div.context ol li {
+                  font-family: ui-monospace, monospace; white-space:pre; color:#666; cursor:pointer; }
+              div.context ol.context-line li { color:black; background-color:#f7f7db; }
+              div.context ol.context-line li span { float: right; }
+              div.commands { margin-left: 40px; }
+              div.commands a { color:black; text-decoration:none; }
+              #summary { background: #1D453C; color: white; }
+              #summary h2 { font-weight: normal; color: white; }
+              #summary ul#quicklinks { list-style-type: none; margin-bottom: 2em; }
+              #summary ul#quicklinks li { float: left; padding: 0 1em; }
+              #summary ul#quicklinks>li+li { border-left: 1px #666 solid; }
+              #summary a { color: #f47c3c; }
+              #explanation { background:#eee; }
+              #traceback { background: white; }
+              #requestinfo { background:#f6f6f6; padding-left:120px; }
+              #summary table { border:none; background:transparent; }
+              #requestinfo h2, #requestinfo h3 { position:relative; margin-left:-100px; }
+              #requestinfo h3 { margin-bottom:-1em; }
+              .error { background: #ffc; }
+              .specific { color:#cc3300; font-weight:bold; }
+            CSS
+          end
+        end
+
+        app.before do
+          if self.class.opts[:bridgetown_site]
+            # The site had previously been initialized via the bridgetown_ssr plugin
+            Bridgetown::Current.sites[self.class.opts[:bridgetown_site].label] =
+              self.class.opts[:bridgetown_site]
+            @context ||= SiteContext.new({ site: self.class.opts[:bridgetown_site] })
+          end
+          Bridgetown::Current.preloaded_configuration ||=
+            self.class.opts[:bridgetown_preloaded_config]
+
+          request.root do
+            output_folder = Bridgetown::Current.preloaded_configuration.destination
+            File.read(File.join(output_folder, "index.html"))
+          rescue StandardError
+            response.status = 500
+            "<p>ERROR: cannot find <code>index.html</code> in the output folder.</p>"
+          end
+        end
+      end
+
+      Roda::RodaRequest.alias_method :_previous_roda_cookies, :cookies
+
+      module RequestMethods
+        # Monkeypatch Roda/Rack's Request object so it returns a hash which allows for
+        # indifferent access
+        def cookies
+          # TODO: maybe replace with a simpler hash that offers an overloaded `[]` method
+          _previous_roda_cookies.with_indifferent_access
+        end
+
+        # Starts up the Bridgetown routing system
+        def bridgetown
+          Bridgetown::Rack::Routes.start!(scope)
+        end
+      end
+    end
+
+    register_plugin :bridgetown_server, BridgetownServer
+  end
+end