bridgetown-core 1.0.0.alpha5 → 1.0.0.alpha9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e1d25e217de2040b4951a2143b0968808ebcd755055351f1745579d362d57df
-  data.tar.gz: 61f132206080c941392bcd1f0bb995f349cadea050dba16b6c02753471e48706
+  metadata.gz: 913ec78ef91ecd5b8e9f56777878f68bcb31625c9af575597bf56a0bf025f252
+  data.tar.gz: f1e4b3292c9f4edf1ebf0318ba2d2751d0b220dc7346536014d4328772cb1879
 SHA512:
-  metadata.gz: 0ff3379e1bf073afd9fd9d5d882cea276c3130fa527e64586faba1c91f8e4d5563b8b59f8d4d3f78abe9589f59511d2c68e824803ba314bbf50a1270df07dfd2
-  data.tar.gz: 7a2afb73e70f34cc0e1e68ee0304c2973b760530ae51f4a6700caad90a897e9c636be4216653b6c08d43accaf9c47380f0217805c7e25c5527ccfafb09510d80
+  metadata.gz: f8affaf97ca29c3e093bf0562259bd9d878ccc216ba63a52ceb3388cfd735b92a32add0dadb8a2b748b7ba416c5a9167c0f6983dc5705b9622fbac445f4fd352
+  data.tar.gz: 56917b674308b501407ab2a4eb7882cc679794e895291db31f4bc80724c1d1e8cbcabd25b86784300e91b0ec3a0cc80bc8789f01730615965fe4b267b8a6570f

data/.rubocop.yml

@@ -11,6 +11,7 @@ AllCops:
     - vendor/**/*
     - tmp/**/*
     - test/source/**/*
+    - test/resources/src/_pages/*.rb
     - lib/site_template/Rakefile
     - lib/site_template/config.ru
     - lib/site_template/config/**/*

data/bin/bridgetown

@@ -19,11 +19,18 @@ Bridgetown::PluginManager.require_from_bundler
 # TODO: need to change behavior of Colorator gem
 ENV["THOR_SHELL"] = "Basic" if ENV["NO_COLOR"]
 
-output_version = if ARGV[0] == "-v"
+output_version = if ARGV[0] == "-v" || ARGV[0] == "--version"
                    puts "bridgetown #{Bridgetown::VERSION} \"#{Bridgetown::CODE_NAME}\""
                    true
                  end
 
+if env_index = ARGV.index { |arg| arg == "-e" } # rubocop:disable Lint/AssignmentInCondition
+  env = ARGV[env_index + 1]
+  ENV["BRIDGETOWN_ENV"] = env if env
+elsif env_flag = ARGV.find { |arg| arg.start_with?("--environment=") } # rubocop:disable Lint/AssignmentInCondition
+  ENV["BRIDGETOWN_ENV"] = env_flag.split("=").last
+end
+
 ENV["RACK_ENV"] = ENV["BRIDGETOWN_ENV"]
 
 require "bridgetown-core/commands/base"

data/bridgetown-core.gemspec

@@ -28,8 +28,7 @@ Gem::Specification.new do |s|
 
   s.rdoc_options = ["--charset=UTF-8"]
 
-  s.required_ruby_version     = ">= 2.5.0"
-  s.required_rubygems_version = ">= 2.7.0"
+  s.required_ruby_version     = ">= 2.7.0"
 
   s.add_runtime_dependency("activemodel",           "~> 6.0")
   s.add_runtime_dependency("activesupport",         "~> 6.0")
@@ -44,12 +43,12 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency("kramdown",              "~> 2.1")
   s.add_runtime_dependency("kramdown-parser-gfm",   "~> 1.0")
   s.add_runtime_dependency("liquid",                "~> 5.0")
-  s.add_runtime_dependency("liquid-component",      ">= 0.1")
   s.add_runtime_dependency("listen",                "~> 3.0")
   s.add_runtime_dependency("rack-indifferent",      ">= 1.2.0")
   s.add_runtime_dependency("rake",                  ">= 13.0")
   s.add_runtime_dependency("roda",                  "~> 3.46")
   s.add_runtime_dependency("rouge",                 "~> 3.0")
+  s.add_runtime_dependency("serbea",                "~> 1.0")
   s.add_runtime_dependency("terminal-table",        "~> 1.8")
   s.add_runtime_dependency("thor",                  "~> 1.1")
   s.add_runtime_dependency("tilt",                  "~> 2.0")

data/lib/bridgetown-core/cache.rb

@@ -144,7 +144,7 @@ module Bridgetown
       @base_dir ||= File.join(Bridgetown::Cache.cache_dir, @name)
       return @base_dir if hash.nil?
 
-      File.join(@base_dir, hash[0..1], hash[2..-1]).freeze
+      File.join(@base_dir, hash[0..1], hash[2..]).freeze
     end
 
     # Given a key, return a SHA2 hash that can be used for caching this item to disk.

data/lib/bridgetown-core/collection.rb

@@ -234,7 +234,7 @@ module Bridgetown
       end
 
       resources.each do |data_resource|
-        segments = data_resource.relative_path.each_filename.to_a[1..-1]
+        segments = data_resource.relative_path.each_filename.to_a[1..]
         nested = []
         segments.each_with_index do |segment, index|
           sanitized_segment = sanitize_filename.(File.basename(segment, ".*"))

data/lib/bridgetown-core/commands/concerns/configuration_overridable.rb

@@ -3,6 +3,13 @@
 module Bridgetown
   module Commands
     module ConfigurationOverridable
+      def self.included(klass)
+        desc = "The environment used for this command (aka development, test, production, etc.)"
+        klass.class_option :environment,
+                           aliases: "-e",
+                           desc: desc
+      end
+
       # Create a full Bridgetown configuration with the options passed in as overrides
       #
       # options - the configuration overrides

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

@@ -41,6 +41,7 @@ module Bridgetown
         configuration_file = find_in_source_paths("#{configuration}.rb")
 
         inside(New.created_site_dir || Dir.pwd) do
+          @templates_dir = File.expand_path("../configurations/#{configuration}", __dir__)
           apply configuration_file, verbose: false
         end
       end
@@ -62,6 +63,12 @@ module Bridgetown
           return Dir.glob("*.rb").map { |file| file.sub(".rb", "") }
         end
       end
+
+      def in_templates_dir(*paths)
+        paths.reduce(@templates_dir) do |base, path|
+          Bridgetown.sanitized_path(base, path.to_s)
+        end
+      end
     end
   end
 end

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

@@ -1,6 +1,38 @@
 # frozen_string_literal: true
 
 module Bridgetown
+  module ConsoleMethods
+    def site
+      Bridgetown::Current.site
+    end
+
+    def collections
+      site.collections
+    end
+
+    def reload!
+      Bridgetown.logger.info "Reloading site..."
+
+      I18n.reload! # make sure any locale files get read again
+      Bridgetown::Hooks.trigger :site, :pre_reload, site
+      Bridgetown::Hooks.clear_reloadable_hooks
+      site.plugin_manager.reload_plugin_files
+      site.loaders_manager.reload_loaders
+
+      ConsoleMethods.site_reset(site)
+    end
+
+    def self.site_reset(site)
+      site.reset
+      Bridgetown.logger.info "Reading files..."
+      site.read
+      Bridgetown.logger.info "", "done!"
+      Bridgetown.logger.info "Running generators..."
+      site.generate
+      Bridgetown.logger.info "", "done!"
+    end
+  end
+
   module Commands
     class Console < Thor::Group
       extend Summarizable
@@ -37,24 +69,18 @@ module Bridgetown
         Bridgetown.logger.info "Environment:", Bridgetown.environment.cyan
         site = Bridgetown::Site.new(configuration_with_overrides(options))
 
-        unless options[:blank]
-          site.reset
-          Bridgetown.logger.info "Reading files..."
-          site.read
-          Bridgetown.logger.info "", "done!"
-          Bridgetown.logger.info "Running generators..."
-          site.generate
-          Bridgetown.logger.info "", "done!"
-        end
+        ConsoleMethods.site_reset(site) unless options[:blank]
 
-        $BRIDGETOWN_SITE = site
+        IRB::ExtendCommandBundle.include ConsoleMethods
         IRB.setup(nil)
         workspace = IRB::WorkSpace.new
         irb = IRB::Irb.new(workspace)
         IRB.conf[:IRB_RC]&.call(irb.context)
         IRB.conf[:MAIN_CONTEXT] = irb.context
-        eval("site = $BRIDGETOWN_SITE", workspace.binding, __FILE__, __LINE__)
-        Bridgetown.logger.info "Console:", "Now loaded as #{"site".cyan} variable."
+        Bridgetown.logger.info "Console:", "Your site is now available as #{"site".cyan}"
+        Bridgetown.logger.info "",
+                               "You can also access #{"collections".cyan} or perform a" \
+                               " #{"reload!".cyan}"
 
         trap("SIGINT") do
           irb.signal_handle

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

@@ -57,8 +57,7 @@ module Bridgetown
       def conflicting_urls(site)
         conflicting_urls = false
         urls = {}
-        urls = collect_urls(urls, site.pages, site.dest)
-        urls = collect_urls(urls, site.collections.posts.docs, site.dest)
+        urls = collect_urls(urls, site.contents, site.dest)
         urls.each do |url, paths|
           next unless paths.size > 1
 
@@ -98,7 +97,11 @@ module Bridgetown
 
       def collect_urls(urls, things, destination)
         things.each do |thing|
-          dest = thing.destination(destination)
+          dest = if thing.method(:destination).arity == 1
+                   thing.destination(destination)
+                 else
+                   thing.destination
+                 end
           if urls[dest]
             urls[dest] << thing.path
           else
@@ -110,8 +113,8 @@ module Bridgetown
 
       def case_insensitive_urls(things, _destination)
         things.each_with_object({}) do |thing, memo|
-          dest = thing.destination.output_path
-          (memo[dest.downcase] ||= []) << dest
+          dest = thing.destination&.output_path
+          (memo[dest.downcase] ||= []) << dest if dest
         end
       end
 

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

@@ -138,7 +138,7 @@ module Bridgetown
 
         if @skipped_bundle
           logger.info "Bundle install skipped.".yellow
-          logger.info "You will need to run #{"bundle binstub bridgetown-core".cyan} manually."
+          logger.info "You will need to run #{"bundle binstubs bridgetown-core".cyan} manually."
         end
 
         logger.info "Yarn install skipped.".yellow if @skipped_yarn
@@ -152,7 +152,8 @@ module Bridgetown
           Bridgetown.with_unbundled_env do
             inside(path) do
               run "bundle install", abort_on_failure: true
-              run "bundle binstub bridgetown-core"
+              run "bundle binstubs bridgetown-core"
+              run "cp bin/bridgetown bin/bt"
             end
           end
         end

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

@@ -30,8 +30,10 @@ module Bridgetown
         Bridgetown::Commands::Build.print_startup_message
         sleep 0.25
 
-        unless Bundler.definition.specs.find { |s| s.name == "puma" }
-          raise "** No Rack-compatible server found **"
+        begin
+          require("puma/detect")
+        rescue LoadError
+          raise "** Puma server gem not found. Check your Gemfile and Bundler env? **"
         end
 
         options = Thor::CoreExt::HashWithIndifferentAccess.new(self.options)

data/lib/bridgetown-core/component.rb

@@ -164,9 +164,9 @@ module Bridgetown
       end
     end
 
-    ruby2_keywords def method_missing(method, *args, &block)
+    def method_missing(method, *args, **kwargs, &block)
       if helpers.respond_to?(method.to_sym)
-        helpers.send method.to_sym, *args, &block
+        helpers.send method.to_sym, *args, **kwargs, &block
       else
         super
       end

data/lib/bridgetown-core/concerns/front_matter_importer.rb

@@ -32,7 +32,7 @@ module Bridgetown
         self.front_matter_line_count = ruby_content[1].lines.size
         process_ruby_data(ruby_content[1], file_path, 2)
       elsif Bridgetown::Utils.has_rbfm_header?(file_path)
-        process_ruby_data(File.read(file_path).lines[1..-1].join("\n"), file_path, 2)
+        process_ruby_data(File.read(file_path).lines[1..].join("\n"), file_path, 2)
       elsif is_a?(Layout)
         self.content = file_contents
         {}

data/lib/bridgetown-core/concerns/site/configurable.rb

@@ -155,10 +155,10 @@ class Bridgetown::Site
       Bridgetown::Cache.disable_disk_cache! if config["disable_disk_cache"]
     end
 
-    def configure_component_paths
+    def configure_component_paths # rubocop:todo Metrics/AbcSize
       # Loop through plugins paths first
       plugin_components_load_paths = Bridgetown::PluginManager.source_manifests
-        .map(&:components).compact
+        .filter_map(&:components)
 
       local_components_load_paths = config["components_dir"].yield_self do |dir|
         dir.is_a?(Array) ? dir : [dir]
@@ -172,7 +172,10 @@ class Bridgetown::Site
         end
       end
 
-      @components_load_paths = plugin_components_load_paths + local_components_load_paths
+      config.components_load_paths = plugin_components_load_paths + local_components_load_paths
+      # Because "first constant wins" in Zeitwerk, we need to load the local
+      # source components _before_ we load any from plugins
+      config.autoload_paths += config.components_load_paths.reverse
     end
 
     def configure_file_read_opts

data/lib/bridgetown-core/concerns/site/extensible.rb

@@ -3,13 +3,14 @@
 class Bridgetown::Site
   module Extensible
     # Load necessary libraries, plugins, converters, and generators.
+    # This is only ever run once for the lifecycle of the site object.
     # @see Converter
     # @see Generator
     # @see PluginManager
     # @return [void]
     def setup
       plugin_manager.require_plugin_files
-      plugin_manager.setup_component_loaders
+      loaders_manager.setup_loaders
       self.converters = instantiate_subclasses(Bridgetown::Converter)
       self.generators = instantiate_subclasses(Bridgetown::Generator)
     end

data/lib/bridgetown-core/concerns/site/ssr.rb

@@ -8,29 +8,16 @@ class Bridgetown::Site
 
     module ClassMethods
       # Establish an SSR pipeline for a persistent backend process
-      def start_ssr! # rubocop:todo Metrics/AbcSize
+      def start_ssr!(loaders_manager: nil, &block)
         if Bridgetown::Current.site
           raise Bridgetown::Errors::FatalException, "Bridgetown SSR already started! " \
                                                     "Check your Rack app for threading issues"
         end
 
         Bridgetown::PluginManager.require_from_bundler
-        site = new(Bridgetown::Current.preloaded_configuration)
+        site = new(Bridgetown::Current.preloaded_configuration, loaders_manager: loaders_manager)
         site.enable_ssr
-
-        Bridgetown::Hooks.trigger :site, :pre_read, site
-        site.defaults_reader.tap do |d|
-          d.path_defaults.clear
-          d.read
-        end
-        site.layouts = Bridgetown::LayoutReader.new(site).read
-        site.collections.data.tap do |coll|
-          coll.read
-          site.data = coll.merge_data_resources
-        end
-        Bridgetown::Hooks.trigger :site, :post_read, site
-
-        yield(site) if block_given? # provide additional setup hook
+        site.ssr_setup(&block)
 
         site
       end
@@ -45,6 +32,41 @@ class Bridgetown::Site
       @ssr_enabled = true
     end
 
+    def ssr_setup(&block) # rubocop:disable Metrics/AbcSize
+      config.serving = true
+      Bridgetown::Hooks.trigger :site, :pre_read, self
+      defaults_reader.tap do |d|
+        d.path_defaults.clear
+        d.read
+      end
+      reader.read_layouts
+      collections.data.tap do |coll|
+        coll.read
+        self.data = coll.merge_data_resources
+      end
+      Bridgetown::Hooks.trigger :site, :post_read, self
+
+      hook = block&.(self) # provide additional setup hook
+      return if Bridgetown.env.production?
+
+      @ssr_reload_hook = hook if hook.is_a?(Proc) && hook.lambda?
+      Bridgetown::Watcher.watch(self, config)
+    end
+
+    def ssr_reload
+      reset soft: true
+      reader.read_layouts
+
+      collections.data.tap do |coll|
+        coll.resources.clear
+        coll.read
+        coll.merge_data_resources.each do |k, v|
+          data[k] = v
+        end
+      end
+      @ssr_reload_hook.() if @ssr_reload_hook.is_a?(Proc)
+    end
+
     def disable_ssr
       Bridgetown.logger.info "SSR:", "now disabled."
       @ssr_enabled = false

data/lib/bridgetown-core/configuration.rb

@@ -11,64 +11,68 @@ module Bridgetown
     # Strings rather than symbols are used for compatibility with YAML.
     DEFAULTS = {
       # Where things are
-      "root_dir"             => Dir.pwd,
-      "plugins_dir"          => "plugins",
-      "source"               => File.join(Dir.pwd, "src"),
-      "destination"          => File.join(Dir.pwd, "output"),
-      "collections_dir"      => "",
-      "cache_dir"            => ".bridgetown-cache",
-      "layouts_dir"          => "_layouts",
-      "data_dir"             => "_data",
-      "components_dir"       => "_components",
-      "partials_dir"         => "_partials",
-      "collections"          => {},
-      "taxonomies"           => {
+      "root_dir"                   => Dir.pwd,
+      "plugins_dir"                => "plugins",
+      "source"                     => File.join(Dir.pwd, "src"),
+      "destination"                => File.join(Dir.pwd, "output"),
+      "collections_dir"            => "",
+      "cache_dir"                  => ".bridgetown-cache",
+      "layouts_dir"                => "_layouts",
+      "data_dir"                   => "_data",
+      "components_dir"             => "_components",
+      "partials_dir"               => "_partials",
+      "collections"                => {},
+      "taxonomies"                 => {
         category: { key: "categories", title: "Category" }, tag: { key: "tags", title: "Tag" },
       },
+      "autoload_paths"             => [],
+      "eager_load_paths"           => [],
+      "autoloader_collapsed_paths" => [],
+      "plugins_use_zeitwerk"       => true,
 
       # Handling Reading
-      "include"              => [".htaccess", "_redirects", ".well-known"],
-      "exclude"              => [],
-      "keep_files"           => [".git", ".svn", "_bridgetown"],
-      "encoding"             => "utf-8",
-      "markdown_ext"         => "markdown,mkdown,mkdn,mkd,md",
-      "strict_front_matter"  => false,
-      "slugify_mode"         => "pretty",
+      "include"                    => [".htaccess", "_redirects", ".well-known"],
+      "exclude"                    => [],
+      "keep_files"                 => [".git", ".svn", "_bridgetown"],
+      "encoding"                   => "utf-8",
+      "markdown_ext"               => "markdown,mkdown,mkdn,mkd,md",
+      "strict_front_matter"        => false,
+      "slugify_mode"               => "pretty",
 
       # Filtering Content
-      "future"               => false,
-      "unpublished"          => false,
-      "ruby_in_front_matter" => true,
+      "future"                     => false,
+      "unpublished"                => false,
+      "ruby_in_front_matter"       => true,
 
       # Conversion
-      "content_engine"       => "resource",
-      "markdown"             => "kramdown",
-      "highlighter"          => "rouge",
-      "excerpt_separator"    => "\n\n",
+      "content_engine"             => "resource",
+      "markdown"                   => "kramdown",
+      "highlighter"                => "rouge",
+      "excerpt_separator"          => "\n\n",
 
       # Serving
-      "port"                 => "4000",
-      "host"                 => "127.0.0.1",
-      "base_path"            => "/",
-      "show_dir_listing"     => false,
+      "port"                       => "4000",
+      "host"                       => "127.0.0.1",
+      "base_path"                  => "/",
+      "show_dir_listing"           => false,
 
       # Output Configuration
-      "available_locales"    => [:en],
-      "default_locale"       => :en,
-      "permalink"            => nil, # default is set according to content engine
-      "timezone"             => nil, # use the local timezone
+      "available_locales"          => [:en],
+      "default_locale"             => :en,
+      "permalink"                  => nil, # default is set according to content engine
+      "timezone"                   => nil, # use the local timezone
 
-      "quiet"                => false,
-      "verbose"              => false,
-      "defaults"             => [],
+      "quiet"                      => false,
+      "verbose"                    => false,
+      "defaults"                   => [],
 
-      "liquid"               => {
+      "liquid"                     => {
         "error_mode"       => "warn",
         "strict_filters"   => false,
         "strict_variables" => false,
       },
 
-      "kramdown"             => {
+      "kramdown"                   => {
         "auto_ids"                => true,
         "toc_levels"              => (1..6).to_a,
         "entity_output"           => "as_char",
@@ -98,6 +102,7 @@ module Bridgetown
       def from(user_config, starting_defaults = DEFAULTS)
         Utils.deep_merge_hashes(starting_defaults.deep_dup, Configuration[user_config])
           .merge_environment_specific_options!
+          .setup_load_paths!
           .setup_locales
           .add_default_collections
           .add_default_excludes
@@ -109,21 +114,21 @@ module Bridgetown
       override[config_key] || self[config_key] || DEFAULTS[config_key]
     end
 
-    # Public: Directory of the top-level root where config files are located
+    # Directory of the top-level root where config files are located
     #
-    # override - the command-line options hash
+    # @param override [Hash] options hash which will override value if key is present
     #
-    # Returns the path to the Bridgetown root directory
-    def root_dir(override = "")
+    # @return [String] path to the Bridgetown root directory
+    def root_dir(override = {})
       get_config_value_with_override("root_dir", override)
     end
 
     # Public: Directory of the Bridgetown source folder
     #
-    # override - the command-line options hash
+    # @param override [Hash] options hash which will override value if key is present
     #
-    # Returns the path to the Bridgetown source directory
-    def source(override = "")
+    # @return [String]  path to the Bridgetown source directory
+    def source(override = {})
       get_config_value_with_override("source", override)
     end
 
@@ -240,6 +245,32 @@ module Bridgetown
         self[k] = self[Bridgetown.environment][k]
       end
       delete(Bridgetown.environment)
+
+      self
+    end
+
+    def setup_load_paths!
+      if self[:plugins_use_zeitwerk]
+        autoload_paths.unshift({
+          path: self[:plugins_dir],
+          eager: true,
+        })
+      end
+
+      autoload_paths.map! do |load_path|
+        if load_path.is_a?(Hash)
+          expanded = File.expand_path(load_path[:path], root_dir)
+          self[:eager_load_paths] << expanded if load_path[:eager]
+          next expanded
+        end
+
+        File.expand_path(load_path, root_dir)
+      end
+
+      autoloader_collapsed_paths.map! do |collapsed_path|
+        File.expand_path(collapsed_path, root_dir)
+      end
+
       self
     end
 

data/lib/bridgetown-core/configurations/bt-postcss.rb

@@ -2,8 +2,6 @@
 
 # rubocop:disable all
 
-TEMPLATE_PATH = File.expand_path("./bt-postcss", __dir__)
-
 unless File.exist?("postcss.config.js")
   error_message = "#{"postcss.config.js".bold} not found. Please configure postcss in your project."
 
@@ -21,6 +19,6 @@ plugins = %w(postcss-easy-import postcss-mixins postcss-color-function cssnano)
 say "Adding the following PostCSS plugins: #{plugins.join(' | ')}", :green
 run "yarn add -D #{plugins.join(' ')}"
 
-copy_file "#{TEMPLATE_PATH}/postcss.config.js", "postcss.config.js", force: true
+copy_file in_templates_dir("postcss.config.js"), "postcss.config.js", force: true
 
 # rubocop:enable all

data/lib/bridgetown-core/configurations/cypress/cypress.json

@@ -0,0 +1,4 @@
+{
+  "baseUrl": "http://localhost:4000"
+}
+

data/lib/bridgetown-core/configurations/cypress/cypress_dir/fixtures/example.json

@@ -0,0 +1,5 @@
+{
+  "name": "Using fixtures to represent data",
+  "email": "hello@cypress.io",
+  "body": "Fixtures are a great way to mock data for responses to routes"
+}

data/lib/bridgetown-core/configurations/cypress/cypress_dir/integration/navbar.spec.js

@@ -0,0 +1,17 @@
+describe("Testing that links exist in the navbar", () => {
+  beforeEach(() => {
+    cy.visit("/");
+  });
+  it("navbar links appear on all pages", () => {
+    const baseUrl = Cypress.config("baseUrl");
+
+    cy.get('[href="/"]').click();
+    cy.url().should("eq", baseUrl + "/");
+
+    cy.get('[href="/posts"]').click();
+    cy.url().should("eq", baseUrl + "/posts");
+
+    cy.get('[href="/about"]').click();
+    cy.url().should("eq", baseUrl + "/about");
+  });
+});

data/lib/bridgetown-core/configurations/cypress/cypress_dir/plugins/index.js

@@ -0,0 +1,21 @@
+/// <reference types="cypress" />
+// ***********************************************************
+// This example plugins/index.js can be used to load plugins
+//
+// You can change the location of this file or turn off loading
+// the plugins file with the 'pluginsFile' configuration option.
+//
+// You can read more here:
+// https://on.cypress.io/plugins-guide
+// ***********************************************************
+
+// This function is called when a project is opened or re-opened (e.g. due to
+// the project's config changing)
+
+/**
+ * @type {Cypress.PluginConfig}
+ */
+module.exports = (on, config) => {
+  // `on` is used to hook into various events Cypress emits
+  // `config` is the resolved Cypress config
+}