bridgetown-core 2.0.0.beta6 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1d84ce34a5f59d6f344056c29003ebaca94ae161ad2ac6b0e65c431e55a83c85
-  data.tar.gz: f09f1457b4a8afe31f15822ce0a453a4cbd049f30dc62cec82871f1d310bf43d
+  metadata.gz: 89df4836f5a8105ce2872c48db38dcf7f710f190e760cb7d083c4610653a6952
+  data.tar.gz: 54b22de4c1cf9e952c680d74fbef3f042c217bfa822a359bd8f5830e096ab8c8
 SHA512:
-  metadata.gz: 8b49a0456bcb39c02a6ca661f16ce30f693845d0460f30a00971785962d23402de1c3c96aa03c07dbf7c15dc9a3ddcb6fab3ccb2638a7e8226cd9ccf8ad1a7ce
-  data.tar.gz: ce6c40abf5657a8c290899765384089793e5c01c54cb1122183d0523585c50ac4d9df422ac24e9cce04ad23f40107baaf255e2b84176752d19d4205316aa85ce
+  metadata.gz: b3e795be0418ead09205b2d46ab7501ba25d5df443973f4f49eaa599b2c91caad5218a279cb50385cf5dfc86146671d7a52e7bcd90631a27be9d547c5e14169e
+  data.tar.gz: 4045cde9174adb8d58208e7032bbac1446ba31983d9aa7853af5ec5f9194789e706ebb01a06171d0282cd0faf87827b0f222f75168cf312bc51dc23324e99256

data/lib/bridgetown-core/commands/build.rb

@@ -97,7 +97,7 @@ module Bridgetown
             ai.ipv4? && !ai.ipv4_loopback?
           end&.ip_address
           scheme = config_options.bind&.split("://")&.first == "ssl" ? "https" : "http"
-          port = ENV.fetch("BRIDGETOWN_PORT", config_options.port)
+          port = config_options.port
           Bridgetown.logger.info ""
           Bridgetown.logger.info "Now serving at:", "#{scheme}://localhost:#{port}".magenta
           Bridgetown.logger.info "", "#{scheme}://#{external_ip}:#{port}".magenta if external_ip

data/lib/bridgetown-core/commands/new.rb

@@ -16,6 +16,11 @@ module Bridgetown
       end
       summary "Creates a new Bridgetown site scaffold in PATH"
 
+      argument :path,
+               type: :string,
+               required: false, # we're changing for path in new_site method
+               desc: "PATH where new Bridgetown site will be created"
+
       class_option :apply,
                    aliases: "-a",
                    banner: "PATH|URL",
@@ -60,9 +65,9 @@ module Bridgetown
       end
 
       def new_site
-        raise ArgumentError, "You must specify a path." if args.empty?
+        raise ArgumentError, "You must specify a path." if path.nil? || path.empty?
 
-        new_site_path = File.expand_path(args.join(" "), Dir.pwd)
+        new_site_path = File.expand_path(path, Dir.pwd)
         @site_name = new_site_path.split(File::SEPARATOR).last
 
         if preserve_source_location?(new_site_path, options)
@@ -77,7 +82,7 @@ module Bridgetown
 
         say_status :create, new_site_path
         create_site new_site_path
-        after_install new_site_path, args.join(" "), options
+        after_install new_site_path, path, options
       rescue ArgumentError => e
         say_status :alert, e.message, :red
       ensure

data/lib/bridgetown-core/commands/start.rb

@@ -42,7 +42,6 @@ module Bridgetown
       class_option :port,
                    aliases: "-P",
                    type: :numeric,
-                   default: 4000,
                    desc: "Serve your site on the specified port. Defaults to 4000."
       class_option :bind,
                    aliases: "-B",
@@ -72,7 +71,7 @@ module Bridgetown
 
         # Load Bridgetown configuration into thread memory
         bt_options = configuration_with_overrides(options)
-        port = ENV.fetch("BRIDGETOWN_PORT", bt_options.port)
+        bt_options.port = port = load_env_and_determine_port(bt_options, options)
         # TODO: support Puma serving HTTPS directly?
         bt_bound_url = "http://#{bt_options.bind}:#{port}"
 
@@ -89,7 +88,7 @@ module Bridgetown
           if server.serveable?
             pid_tracker.create_pid_dir
 
-            bt_options.skip_live_reload = !server.using_puma?
+            bt_options.skip_live_reload ||= !server.using_puma?
 
             build_args = ["-w"] + ARGV.reject { |arg| arg == "start" }
             build_pid = Process.fork { Bridgetown::Commands::Build.start(build_args) }
@@ -125,6 +124,22 @@ module Bridgetown
           "config.ru" :
           File.expand_path("../rack/default_config.ru", __dir__)
       end
+
+      def load_env_and_determine_port(config, options)
+        initializer_file = File.join(config.root_dir, "config", "initializers.rb")
+        if File.exist?(initializer_file) &&
+            File.read(initializer_file) =~ (%r!^[\s]*init[\s]*:dotenv!)
+          require "dotenv"
+          Bridgetown.load_dotenv(root: config.root_dir)
+        end
+
+        # Options ordering for "who wins" is:
+        #   1. CLI
+        #   2. BRIDGETOWN_PORT env var
+        #   3. YAML config (if present)
+        #   4. 4000
+        options[:port] || ENV.fetch("BRIDGETOWN_PORT", config.port || 4000)
+      end
     end
   end
 end

data/lib/bridgetown-core/configuration/configuration_dsl.rb

@@ -3,6 +3,8 @@
 module Bridgetown
   class Configuration
     class ConfigurationDSL < Bridgetown::FrontMatter::RubyFrontMatter
+      include Bridgetown::Refinements::Helper
+
       attr_reader :context
 
       # @yieldself [ConfigurationDSL]

data/lib/bridgetown-core/configurations/feed.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+say_status :feed, "Adding bridgetown-feed gem..."
+
+add_gem "bridgetown-feed"
+add_initializer :"bridgetown-feed"
+
+head_file = Dir.glob("src/**/{head.liquid,_head.erb,_head.serb}").first
+
+unless head_file
+  say_status :feed, "Feed tags could not be automatically inserted"
+  say_status :feed, "To enable, output `feed` in the application <head> element" \
+                    "using the relevant template language tags"
+  say "For further reading, check out " \
+      '"https://github.com/bridgetownrb/bridgetown-feed#readme"', :blue
+
+  return
+end
+
+say_status :feed, "Adding feed tags to #{head_file}..."
+
+feed_tag = Bridgetown::Utils.helper_code_for_template_extname(
+  File.extname(head_file),
+  "feed_meta"
+)
+
+File.open(head_file, "a+") do |file|
+  file.write("#{feed_tag}\n") unless file.grep(%r{#{feed_tag}}).any?
+end
+
+say_status :feed, "bridgetown-feed is now configured!"
+say "For further reading, check out " \
+    '"https://github.com/bridgetownrb/bridgetown-feed#readme"', :blue

data/lib/bridgetown-core/configurations/lit/esbuild-plugins.js

@@ -4,21 +4,20 @@
 
 // This plugin will let you import `.lit.css` files as sidecar stylesheets.
 // Read https://www.bridgetownrb.com/docs/components/lit#sidecar-css-files for documentation.
-const { litCssPlugin } = require("esbuild-plugin-lit-css")
-const postcssrc = require("postcss-load-config")
-const postcss = require("postcss")
+import { litCssPlugin } from "esbuild-plugin-lit-css"
+import postcss from "postcss"
 
-module.exports = {
-  plugins: [
-    litCssPlugin({
-      filter: /\.lit\.css$/,
-      transform: async (css, { filePath }) => {
-        const postCssConfig = await postcssrc()
-        const postCssProcessor = postcss([...postCssConfig.plugins])
+const postcssrc = (await import("postcss-load-config")).default
 
-        const results = await postCssProcessor.process(css, { ...postCssConfig.options, from: filePath })
-        return results.css
-      }
-    }),
-  ]
-}
+export const plugins = [
+  litCssPlugin({
+    filter: /\.lit\.css$/,
+    transform: async (css, { filePath }) => {
+      const postCssConfig = await postcssrc()
+      const postCssProcessor = postcss([...postCssConfig.plugins])
+
+      const results = await postCssProcessor.process(css, { ...postCssConfig.options, from: filePath })
+      return results.css
+    }
+  }),
+]

data/lib/bridgetown-core/configurations/lit/lit-ssr.config.js

@@ -1,5 +1,5 @@
-const build = require("bridgetown-lit-renderer/build")
-const { plugins } = require("./esbuild-plugins.js")
+import build from "bridgetown-lit-renderer/build"
+import { plugins } from "./esbuild-plugins.js"
 
 const esbuildOptions = { plugins }
 

data/lib/bridgetown-core/configurations/lit.rb

@@ -11,19 +11,19 @@ end
 
 say_status :lit, "Installing Lit + SSR Plugin..."
 
-add_gem "bridgetown-lit-renderer", version: "2.1.0.beta2"
+add_gem "bridgetown-lit-renderer", version: "3.0.0"
 
-add_npm_package "lit esbuild-plugin-lit-css bridgetown-lit-renderer@2.1.0-beta2"
+add_npm_package "lit esbuild-plugin-lit-css bridgetown-lit-renderer@3.0.0"
 
 copy_file in_templates_dir("lit-ssr.config.js"), "config/lit-ssr.config.js"
 copy_file in_templates_dir("lit-components-entry.js"), "config/lit-components-entry.js"
 copy_file in_templates_dir("esbuild-plugins.js"), "config/esbuild-plugins.js"
 
 insert_into_file "esbuild.config.js",
-                 after: 'const build = require("./config/esbuild.defaults.js")' do
+                 after: 'import build from "./config/esbuild.defaults.js"' do
   <<~JS
 
-    const { plugins } = require("./config/esbuild-plugins.js")
+    import { plugins } from "./config/esbuild-plugins.js"
   JS
 end
 

data/lib/bridgetown-core/configurations/render/render.yaml.erb

@@ -1,13 +1,10 @@
 services:
   - type: web
     name: <%= @render_service_name %>
-    env: static
+    runtime: static
     buildCommand: bin/bridgetown deploy
     staticPublishPath: ./output
     pullRequestPreviewsEnabled: true
-    envVars:
-      - key: BRIDGETOWN_ENV
-        value: production
     headers:
       - path: /*
         name: X-Frame-Options
@@ -27,3 +24,42 @@ services:
       - path: /*
         name: Cache-Control
         value: "public, max-age=86400, s-max-age=86400"
+    envVars:
+      - key: BRIDGETOWN_ENV
+        value: production
+###########
+# Uncomment and modify the following for hybrid deployments, database support, etc.
+#   Use the `routes` rewrite feature to "poke holes" through your static CDN to specific
+#   route handlers in your Roda server application.
+###########
+#
+#       - key: DATABASE_URL
+#         fromDatabase:
+#           name: <%= @render_service_name %>_proddb
+#           property: connectionString
+#       - fromGroup: <%= @render_service_name %>-prod-envs
+#     routes:
+#       - type: rewrite
+#         source: /account/*
+#         destination: https://<%= @render_service_name %>-api.onrender.com/account/*
+#       - type: rewrite
+#         source: /auth/*
+#         destination: https://<%= @render_service_name %>-api.onrender.com/auth/*
+#   - type: web
+#     name: <%= @render_service_name %>-api
+#     plan: standard
+#     runtime: ruby
+#     buildCommand: bundle install && npm install && bin/bridgetown frontend:build
+#     startCommand: bin/bridgetown start
+#     envVars:
+#       - key: BRIDGETOWN_ENV
+#         value: production
+#       - key: DATABASE_URL
+#         fromDatabase:
+#           name: <%= @render_service_name %>_proddb
+#           property: connectionString
+#       - fromGroup: <%= @render_service_name %>-prod-envs
+# databases:
+#   - name: <%= @render_service_name %>_proddb
+#     plan: starter
+#     databaseName: <%= @render_service_name %>_production

data/lib/bridgetown-core/configurations/render.rb

@@ -3,4 +3,11 @@
 @render_service_name = ask "What would like to call your Render service?"
 template in_templates_dir("render.yaml.erb"), "render.yaml"
 
-say "All done. Just create a new blueprint from the Render dashboard and connect this repo."
+say_status :render, "Your render.yaml file is now configured!"
+say ""
+say "Verify its contents and once ready, create a new blueprint from the Render dashboard"
+say "and connect your repo."
+say ""
+say "Optionally, if you're setting up a backend API and database, create a environment group"
+say "on Render called [yourservicehere]-prod-envs for sharing environment variables between"
+say "multiple servers."

data/lib/bridgetown-core/configurations/seo.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+say_status :seo, "Adding bridgetown-seo-tag gem..."
+
+add_gem "bridgetown-seo-tag"
+add_initializer :"bridgetown-seo-tag"
+
+head_file = Dir.glob("src/**/{head.liquid,_head.erb,_head.serb}").first
+
+unless head_file
+  say_status :seo, "SEO tags could not be automatically inserted"
+  say_status :seo, "To enable SEO, output `seo` in the application <head> element" \
+                   "using the relevant template language tags"
+  say "For further reading, check out " \
+      '"https://github.com/bridgetownrb/bridgetown-seo-tag#readme"', :blue
+
+  return
+end
+
+say_status :seo, "Adding SEO tags to #{head_file}..."
+
+seo_tag = Bridgetown::Utils.helper_code_for_template_extname(
+  File.extname(head_file),
+  "seo"
+)
+
+File.open(head_file, "a+") do |file|
+  file.write("#{seo_tag}\n") unless file.grep(%r{#{seo_tag}}).any?
+end
+
+say_status :seo, "bridgetown-seo-tag is now configured!"
+say "For further reading, check out " \
+    '"https://github.com/bridgetownrb/bridgetown-seo-tag#readme"', :blue

data/lib/bridgetown-core/configurations/shoelace.rb

@@ -1,60 +1,6 @@
 # frozen_string_literal: true
 
-say_status :shoelace, "Installing Shoelace..."
+say "Shoelace is now Web Awesome!"
+say ""
 
-add_npm_package "@shoelace-style/shoelace"
-
-stylesheet_import = <<~CSS
-  /* Import the base Shoelace stylesheet: */
-  @import "@shoelace-style/shoelace/dist/themes/light.css";
-
-CSS
-
-if File.exist?("frontend/styles/index.css")
-  prepend_to_file "frontend/styles/index.css", stylesheet_import
-elsif File.exist?("frontend/styles/index.scss")
-  prepend_to_file "frontend/styles/index.scss", stylesheet_import
-else
-  say "\nPlease add the following lines to your CSS index file:"
-  say stylesheet_import
-end
-
-say 'Adding Shoelace to "frontend/javascript/index.js"...', :magenta
-
-javascript_import do
-  <<~JS
-
-    // Example Shoelace components. Mix 'n' match however you like!
-    import "@shoelace-style/shoelace/dist/components/button/button.js"
-    import "@shoelace-style/shoelace/dist/components/icon/icon.js"
-    import "@shoelace-style/shoelace/dist/components/spinner/spinner.js"
-
-    // Use the public icons folder:
-    import { setBasePath } from "@shoelace-style/shoelace/dist/utilities/base-path.js"
-    setBasePath("/shoelace-assets")
-  JS
-end
-
-say "Updating frontend build commands...", :magenta
-
-insert_into_file "package.json", before: '    "esbuild": "node' do
-  <<-JS
-  "shoelace:copy-assets": "mkdir -p src/shoelace-assets && cp -r node_modules/@shoelace-style/shoelace/dist/assets src/shoelace-assets",
-  JS
-end
-gsub_file "package.json", %r{"esbuild": "node}, '"esbuild": "npm run shoelace:copy-assets && node'
-gsub_file "package.json", %r{"esbuild-dev": "node},
-          '"esbuild-dev": "npm run shoelace:copy-assets && node'
-
-if File.exist?(".gitignore")
-  append_to_file ".gitignore" do
-    <<~FILES
-
-      src/shoelace-assets
-    FILES
-  end
-end
-
-say_status :shoelace, "Shoelace is now configured!"
-
-say 'For further reading, check out "https://shoelace.style"', :blue
+Bridgetown::Commands::Configure.start(["webawesome"])

data/lib/bridgetown-core/configurations/webawesome.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+say_status :webawesome, "Installing Web Awesome..."
+
+add_npm_package "@awesome.me/webawesome"
+
+stylesheet_import = <<~CSS
+  /* Import the base Web Awesome stylesheet: */
+  @import "@awesome.me/webawesome/dist/styles/webawesome.css";
+
+CSS
+
+if File.exist?("frontend/styles/index.css")
+  say 'Adding Web Awesome stylesheet import to "frontend/styles/index.css"...', :magenta
+  prepend_to_file "frontend/styles/index.css", stylesheet_import
+elsif File.exist?("frontend/styles/index.scss")
+  say 'Adding Web Awesome stylesheet import to "frontend/styles/index.scss"...', :magenta
+  prepend_to_file "frontend/styles/index.scss", stylesheet_import
+else
+  say "\nPlease add the following lines to your CSS index file:"
+  say stylesheet_import
+end
+
+say 'Adding Web Awesome component imports to "frontend/javascript/index.js"...', :magenta
+
+javascript_import do
+  <<~JS
+
+    // Example Web Awesome components. Mix 'n' match however you like!
+    import "@awesome.me/webawesome/dist/components/button/button.js"
+    import "@awesome.me/webawesome/dist/components/icon/icon.js"
+    import "@awesome.me/webawesome/dist/components/spinner/spinner.js"
+  JS
+end
+
+say_status :webawesome, "Web Awesome is now configured!"
+
+say 'For further reading, check out "https://webawesome.com"', :blue

data/lib/bridgetown-core/converter.rb

@@ -9,12 +9,25 @@ module Bridgetown
       #
       # * `input :erb`
       # * `input %i(xls xlsx)`
+      #
+      # @param extnames [Array<Symbol>] extensions
       def input(extnames)
         extnames = Array(extnames)
         self.extname_list ||= []
         self.extname_list += extnames.map { |e| ".#{e.to_s.downcase}" }
       end
 
+      # Set or return the delimiters used for helper calls in template code
+      # (e.g. `["<%=", "%>"]` for ERB). This is purely informational for the framework's benefit,
+      # not used within a rendering pipeline.
+      #
+      # @param delimiters [Array<String>] delimiters
+      def helper_delimiters(delimiters = nil)
+        return @helper_delimiters if delimiters.nil?
+
+        @helper_delimiters = delimiters
+      end
+
       def supports_slots? = @support_slots
 
       def support_slots(bool = true) # rubocop:disable Style/OptionalBooleanParameter

data/lib/bridgetown-core/converters/erb_templates.rb

@@ -107,6 +107,7 @@ module Bridgetown
       priority :highest
       input :erb
       template_engine :erb
+      helper_delimiters ["<%=", "%>"]
 
       # Logic to do the ERB content conversion.
       #

data/lib/bridgetown-core/converters/liquid_templates.rb

@@ -6,6 +6,7 @@ module Bridgetown
       priority :highest
       input :liquid
       template_engine :liquid
+      helper_delimiters ["{%", "%}"]
 
       attr_reader :site, :document, :layout
 

data/lib/bridgetown-core/converters/serbea_templates.rb

@@ -24,6 +24,7 @@ module Bridgetown
       priority :highest
       template_engine :serbea
       input :serb
+      helper_delimiters ["{%=", "%}"]
 
       # Logic to do the Serbea content conversion
       #

data/lib/bridgetown-core/helpers.rb

@@ -6,6 +6,7 @@ module Bridgetown
   class RubyTemplateView
     class Helpers
       using Bridgetown::Refinements
+      include Bridgetown::Refinements::Helper
       include Bridgetown::Filters
       include Bridgetown::Filters::FromLiquid
       include ::Streamlined::Helpers
@@ -127,12 +128,10 @@ module Bridgetown
       # Provide backwards compatibility via Streamlined helper
       alias_method :attributes_from_options, :html_attributes
 
-      # Delegates to <tt>I18n#translate</tt> but also performs two additional
-      # functions.
+      # Delegates to `I18n#translate` but with some additional smarts.
       #
-      # First, if the key starts with a period <tt>translate</tt> will scope
-      # the key by the current view. Calling <tt>translate(".foo")</tt> from
-      # the <tt>people/index.html.erb</tt> template is equivalent to calling
+      # You can scope to the current view. Calling <tt>translate(".foo")</tt> from
+      # the <tt>people/index.erb</tt> template is equivalent to calling
       # <tt>translate("people.index.foo")</tt>. This makes it less
       # repetitive to translate many keys within the same view and provides
       # a convention to scope keys consistently.
@@ -148,14 +147,14 @@ module Bridgetown
       #
       # @return [String] the translated string
       # @see I18n
-      def translate(key, **options) # rubocop:disable Metrics/CyclomaticComplexity, Metrics/PerceivedComplexity
+      def translate(key, **options)
         return key.map { |k| translate(k, **options) } if key.is_a?(Array)
 
         key = key&.to_s
 
         if key&.start_with?(".")
-          view_path = view&.page&.relative_path&.to_s&.split(".")&.first
-          key = "#{view_path.tr("/", ".")}#{key}" if view_path.present?
+          view_path = Bridgetown::Filters::URLFilters.strip_extname(view.resource.relative_path)
+          key = "#{view_path.tr("_/", " .").lstrip}#{key}"
         end
 
         return I18n.translate(key, **options) unless %r{(?:_|\b)html\z}.match?(key)
@@ -264,14 +263,19 @@ module Bridgetown
         end
       end
 
-      # TODO: docu
+      # Output a declarative shadow DOM tag to wrap the input argument or block
+      #
+      # @param input [String] content to wrap if block isn't provided
+      # @return [String]
       def dsd(input = nil, &block)
         tmpl_content = block.nil? ? input.to_s : view.capture(&block)
 
         Bridgetown::Utils.dsd_tag(tmpl_content)
       end
 
-      # TODO: docu
+      # Load a sidecar CSS file with a .dsd.css extension and output a style tag
+      #
+      # @return [String]
       def dsd_style
         tmpl_path = caller_locations(1, 2).find do |loc|
                       loc.label.include?("method_missing").!
@@ -292,7 +296,8 @@ module Bridgetown
         style_tag.html_safe
       end
 
-      # TODO: docu
+      # If you need to access signals without creating a tracking dependency, wrap a
+      # block of code in this helper
       def bypass_tracking(...) = Signalize.untracked(...)
     end
   end

data/lib/bridgetown-core/plugin_manager.rb

@@ -102,7 +102,7 @@ module Bridgetown
 
     # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
 
-    # Iterates through loaded gems and finds npm-add gemspec metadata.
+    # Iterates through loaded gems and finds npm_add gemspec metadata.
     # If that exact package hasn't been installed, execute npm i
     #
     # @return [Bundler::SpecSet]
@@ -134,7 +134,7 @@ module Bridgetown
     end
 
     def self.find_npm_dependency(loaded_gem)
-      npm_metadata = loaded_gem.to_spec&.metadata&.dig("npm-add") ||
+      npm_metadata = loaded_gem.to_spec&.metadata&.dig("npm_add") ||
         loaded_gem.to_spec&.metadata&.dig("yarn-add")
       npm_dependency = npm_metadata&.match(NPM_DEPENDENCY_REGEXP)
       return nil if npm_dependency&.length != 3 || npm_dependency[2] == ""

data/lib/bridgetown-core/tasks/bridgetown_tasks.rake

@@ -11,7 +11,7 @@ namespace :frontend do
   task :watcher, :sidecar do |_task, args|
     # sidecar is when the task is running alongside the start command
     sidecar = args[:sidecar] == true
-    Bridgetown::Utils::Aux.run_process "Frontend", :yellow, "bridgetown frontend:dev"
+    Bridgetown::Utils::Aux.run_process "Frontend", :blue, "bridgetown frontend:dev"
 
     if sidecar
       # give FE bundler time to boot before returning control to the start command

data/lib/bridgetown-core/utils.rb

@@ -116,7 +116,7 @@ module Bridgetown
       raise Errors::InvalidDateError, "Invalid date '#{input}': #{msg}"
     end
 
-    # Determines whether a given file has
+    # Determines whether a given file has YAML front matter
     #
     # @return [Boolean] if the YAML front matter is present.
     def has_yaml_header?(file) # rubocop: disable Naming/PredicateName
@@ -485,6 +485,27 @@ module Bridgetown
       %(<template shadowrootmode="#{shadow_root_mode}">#{input}</template>).html_safe
     end
 
+    def helper_code_for_template_extname(extname, content)
+      template_engines_providing_delimiters =
+        Bridgetown::Converter.subclasses
+          .filter_map do |converter|
+            [converter, converter.extname_list] if converter.helper_delimiters
+          end.to_h
+      found_template_engine =
+        template_engines_providing_delimiters.find do |_, extnames|
+          extnames.include?(extname)
+        end&.first
+
+      unless found_template_engine
+        raise "No template engine using file extension #{extname}" \
+              "is currently supported for code generation"
+      end
+
+      start_tag, end_tag = found_template_engine.helper_delimiters
+
+      [start_tag, content, end_tag].join(" ")
+    end
+
     private
 
     def merge_values(target, overwrite)

data/lib/roda/plugins/bridgetown_server.rb

@@ -102,6 +102,8 @@ class Roda
       end
 
       module InstanceMethods
+        include Bridgetown::Refinements::Helper
+
         def initialize_bridgetown_context
           if self.class.opts[:bridgetown_site]
             # The site had previously been initialized via the bridgetown_ssr plugin
@@ -157,9 +159,15 @@ class Roda
           scope.initialize_bridgetown_root
 
           base_path = Bridgetown::Current.preloaded_configuration.base_path.delete_prefix("/")
-          on(base_path.empty? ? true : base_path) do
+
+          if base_path.empty?
             ssg # static file server
             Bridgetown::Rack::Routes.load_all scope
+          else
+            on(base_path) do
+              ssg # static file server
+              Bridgetown::Rack::Routes.load_all scope
+            end
           end
         end
       end

data/lib/site_template/config/puma.rb

@@ -2,9 +2,10 @@
 #
 # Learn more at: https://puma.io
 # Bridgetown configuration documentation:
-# https://edge.bridgetownrb.com/docs/configuration/puma
+# https://www.bridgetownrb.com/docs/configuration/puma
 
-# This port number can be overriden by a bind configuration option
+# This port number typically gets overridden by Bridgetown's boot & config loader
+# so you probably don't want to touch the number here
 #
 port ENV.fetch("BRIDGETOWN_PORT") { 4000 }
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bridgetown-core
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta6
+  version: 2.0.1
 platform: ruby
 authors:
 - Bridgetown Team
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-30 00:00:00.000000000 Z
+date: 2025-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -64,14 +64,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta6
+        version: 2.0.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 2.0.0.beta6
+        version: 2.0.1
 - !ruby/object:Gem::Dependency
   name: csv
   requirement: !ruby/object:Gem::Requirement
@@ -463,6 +463,7 @@ files:
 - lib/bridgetown-core/configurations/cypress/cypress_dir/support/commands.js
 - lib/bridgetown-core/configurations/cypress/cypress_dir/support/index.js
 - lib/bridgetown-core/configurations/cypress/cypress_tasks
+- lib/bridgetown-core/configurations/feed.rb
 - lib/bridgetown-core/configurations/gh-pages.rb
 - lib/bridgetown-core/configurations/gh-pages/gh-pages.yml
 - lib/bridgetown-core/configurations/is-land.rb
@@ -482,6 +483,7 @@ files:
 - lib/bridgetown-core/configurations/ruby2js.rb
 - lib/bridgetown-core/configurations/ruby2js/hello_world.js.rb
 - lib/bridgetown-core/configurations/ruby2js/ruby2js.rb
+- lib/bridgetown-core/configurations/seo.rb
 - lib/bridgetown-core/configurations/shoelace.rb
 - lib/bridgetown-core/configurations/stimulus.rb
 - lib/bridgetown-core/configurations/tailwindcss.rb
@@ -490,6 +492,7 @@ files:
 - lib/bridgetown-core/configurations/vercel.rb
 - lib/bridgetown-core/configurations/vercel/vercel.json
 - lib/bridgetown-core/configurations/vercel/vercel_url.rb
+- lib/bridgetown-core/configurations/webawesome.rb
 - lib/bridgetown-core/converter.rb
 - lib/bridgetown-core/converters/erb_templates.rb
 - lib/bridgetown-core/converters/identity.rb
@@ -668,9 +671,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 3.1.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.3.26
 signing_key: