brut 0.0.27 → 0.0.29

data/brutrb.com/getting-started.md

@@ -1,21 +1,26 @@
 # Getting Started
 
 Brut is developed alongside a separate gem called `mkbrut`, which allows you to
-create a new Brut app. It will set up you dev environment as well.
+create a new Brut app. It will set up your dev environment as well.
 
 ## Get `mkbrut`
 
-If you have a Ruby 3.4 (or later) environment set up on your computer, you can use 
-RubyGems:
+The simplest way to use `mkbrut` is to use an existing [Docker image](https://hub.docker.com/repository/docker/thirdtank/mkbrut/general).  You don't have to install or configure Ruby:
 
 ```
-gem install mkbrut
+docker run \
+       -v "$PWD":"$PWD" \
+       -w "$PWD" \
+       -it \
+       thirdtank/mkbrut \
+       mkbrut my-new-app
 ```
 
-If not, we recommend you use a pre-built Docker image:
+If you already have Ruby 3.4 installed, you can install `mkbrut` directly:
 
 ```
-docker pull XXXX
+> gem install mkbrut
+> mkbrut my-new-app
 ```
 
 ## Init Your App
@@ -23,16 +28,44 @@ docker pull XXXX
 A Brut app just needs a name, which will be used to derive a few more useful values.
 For now:
 
+::: code-group
+
+``` [Docker-based]
+docker run \
+       -v "$PWD":"$PWD" \
+       -w "$PWD" \
+       -it \
+       thirdtank/mkbrut \
+       mkbrut my-new-app
 ```
+
+``` [RubyGems-based]
 mkbrut my-new-app
 ```
 
-This will create your new app, along with some demo routes, components, handlers, and tests. If this is your first time using Brut, we recommend you examine these demo components.  However, if you just want to skip all that:
+:::
+
+This will create your new app, along with some demo routes, components, handlers, and tests. If this is your first time using Brut, we recommend you examine these demo components.
+
+To create your app without the demo components:
 
+::: code-group
+
+``` [Docker-based]
+docker run \
+       -v "$PWD":"$PWD" \
+       -w "$PWD" \
+       -it \
+       thirdtank/mkbrut \
+       mkbrut my-new-app --no-demo
 ```
-mkbrut --no-demo my-new-app
+
+``` [RubyGems-based]
+mkbrut my-new-app --no-demo
 ```
 
+:::
+
 ## Start Your Dev Environment
 
 Brut includes a dev environment based on Docker.  It uses Docker compose to run a
@@ -50,49 +83,52 @@ Docker container for local observability via OpenTelemetry.
    ```
    > dx/start
    ```
-4. Install gems and modules for your app. In another terminal:
+4. Now, "log in" to the container where your app and its tests will run:
 
    ```
-   > dx/exec bin/setup
+   > dx/exec login
    ```
 
-   OR:
+5. Set everything up:
 
    ```
-   > dx/exec bash
    inside-container> bin/setup
    ```
 
-Now, you're ready to go
+Now, you're ready to go.  See [Dev Environemnt](/dev-environment) for details on how
+this all works.
 
 ## Run the App
 
 ```
-> dx/exec bin/dev
-```
-
-OR
-
-```
-> dx/exec bash
-> bin/dev
+inside-container> bin/dev
 ```
 
 You can now visit your app at `localhost:6502`
 
-## Run the Tests
+You can make changes and see them when you reload.  Open up `app/src/front_end/pages/home_page.rb` *in your editor running on your computer* and change the `h1` to look like so:
 
-Even without the demo, there are a few components set up, and there are some tests:
+```ruby {6}
+class HomePage < AppPage
+  def page_template
+    div(class: "flex flex-column items-center justify-center h-80vh") do
+      img(src: "/static/images/icon.png", class: "h-50")
+      h1(class: "ff-sans ma-0 lh-title f-5") do
+        "Welcome to My New App!"
+      end
 
+      # ...
 ```
-> dx/exec bin/ci
-```
 
-OR
+When you reload your browser, you'll see your change
+
+## Run the Tests
+
+There are a few tests you can run, as well as some checks that you aren't using
+RubyGems with security vulnerabilities.  Run it all now with `bin/ci`:
 
 ```
-> dx/exec bash
-> bin/ci
+inside-container> bin/dev
 ```
 
 ## Now Build The Rest of Your App 🦉

data/brutrb.com/index.md

@@ -6,8 +6,8 @@ hero:
   name: "Brut RB"
   text: "Raw Ruby Web Apps"
   tagline: Standards-based, No-nonsense, HTML-first, Low Ceremony
-  image:
-    src: /images/logo.png
+  ximage:
+    src: /images/LogoTall.png
     alt: "A Ruby gemstone embedded into a concrete, brutalist building"
   actions:
     - theme: brand
@@ -20,7 +20,7 @@ hero:
       text: Conceptual Overview
       link: /overview
 
-features:
+xfeatures:
   - title: Standards-Based
     icon:  📄
     details: "Brut leverages HTML, HTTP, SQL, and the Ruby standard library to let you write apps using standards you already know…or could quickly learn"
@@ -34,3 +34,4 @@ features:
     icon: 🏘️
     details: "Sequel, Phlex, I18n, RSpec. They do it best"
 ---
+![logo](/images/LogoStop.png)

data/brutrb.com/instrumentation.md

@@ -66,6 +66,17 @@ Here is a non-exhaustive list of what Brut automatically instruments:
 * Ignored parameters on all form submissions
 * How long reloading takes in development
 * CSP reporting results
+* SQL Statements
+
+> [!WARNING]
+> `Sequel::Extensions::BrutInstrumentation` sets up telemetry for
+> Sequel, and it does it in a relatively simplistic way.  The result
+> is that *all* SQL statements are part of the telemetry, including
+> the actual values inserted or used in `WHERE` clauses.
+> While you should not be putting sensitive data into your database,
+> be warned that this is happening. There are plans to improve this
+> to be more flexible and reduce the Schance of sensitive data
+> being sent in traces.
 
 ### Adding Your Own Instrumentation
 
@@ -175,6 +186,7 @@ specific issues.
 
 _Last Updated June 12, 2025_
 
+
 Brut does not have plans to support non-OTel instrumentation, nor does it have plans to provide hooks to
 use proprietary formats.  This could change of course.
 

data/brutrb.com/layouts.md

@@ -0,0 +1,130 @@
+# Layouts
+
+Brut supports *layouts*, which are a way to centralizing common HTML amongst many
+different pages.  Conceptually, they are the same as a Rails layout.  Technically, they are a Phlex component designed to render a page from a `yield` block.
+
+## Overview
+
+Your app should include `app/src/front_end/layouts/default_layout.rb`. The name
+"default" is special, in that all pages will use this layout by default.
+
+Since a layout is a Phlex component, its HTML is generated from `view_template`, and
+it is expected to have exactly one `yield`, where the page's content will be
+inserted.
+
+```ruby {33}
+class DefaultLayout < Brut::FrontEnd::Layout
+  include Brut::FrontEnd::Components
+
+  def initialize(page_name:)
+    @page_name = page_name
+  end
+
+  def view_template
+    doctype
+    html(lang: "en") do
+      head do
+        meta(charset: "utf-8")
+        meta(content: "width=device-width,initial-scale=1", name:"viewport")
+        meta(content: "website", property:"og:type")
+        link(rel: "manifest",  href: "/static/manifest.json")
+        link(rel: "preload", as: "style", href: asset_path("/css/styles.css"))
+        link(rel: "stylesheet",           href: asset_path("/css/styles.css"))
+        script(defer: true, src: asset_path("/js/app.js"))
+        title { app_name }
+        PageIdentifier(@page_name)
+        I18nTranslations("cv.fe")
+        I18nTranslations("cv.this_field")
+        Traceparent()
+        render(
+          Brut::FrontEnd::RequestContext.inject(
+            Brut::FrontEnd::Components::LocaleDetection
+          )
+        )
+      end
+      body do
+        brut_tracing url: "/__brut/instrumentation", show_warnings: true
+        main class: @page_name do
+          yield
+        end
+      end
+    end
+  end
+end
+```
+
+### Maintaining Layouts
+
+You are free to manage this how you like, however a few components inside the
+`<head>` and `<body>` that are important to keep:
+
+* `Brut::FrontEnd::Components::PageIdentifier` includes a `<meta>` tag with the page's name in it, which is handy for managing your end-to-end tests.
+* `Brut::FrontEnd::Components::I18nTranslations` includes translatsion for common client-side constraint violations.  See [Forms](/forms), [I18n](/i18n), and [JavaScript](/javascript) for more details on how this is used.
+* `Brut::FrontEnd::Components::Traceparent` ensures that the OpenTelemetry *traceparent* is available so when client-side telemetry is reported back to the server, it can be connected to the request that initiated it.
+* The `<brut-tracing>` element collects the client-side telemetry and sends it back
+to the server.
+
+### Creating Alternate Layouts
+
+The way each page knows to use `DefaultLayout` is due to the `layout` method of
+`Brut::FrontEnd::Page`, which returns `"default"`.  The return value of `layout` is
+used to figure out the name of the layout class.
+
+You can set up your own by overriding `layout`:
+
+```ruby
+class MyOtherPage < AppPage
+  def layout = "other_design"
+
+  # ...
+
+end
+```
+
+Brut will expect the class `OtherDesignLayout` to exist and provide HTML.  Based on
+Zeitwerk's conventions, that class should be in
+`app/src/front_end/layouts/other_design_layout.rb`.
+
+### No Layout
+
+If you don't want a layout, you are encouraged to creat a blank layout, for example:
+
+```ruby
+class BlankLayout < Brut::FrontEnd::Layout
+  def view_template
+    yield
+  end
+end
+
+# use like so:
+
+def layout = "blank"
+```
+
+## Testing
+
+You generally don't test a layout, aside from end-to-end tests.  If your layout
+needs complex logic, you are encouraged to extract that to a
+[component](/components) and test that instead.
+
+## Recommended Practices
+
+Keep your layouts as simple as you can.
+
+
+
+## Technical Notes
+
+> [!IMPORTANT]
+> Technical Notes are for deeper understanding and debugging. While we will try to keep them up-to-date with changes to Brut's
+> internals, the source code is always more correct.
+
+_Last Updated July 1, 2025_
+
+Layouts work due to the implementation of the method `view_template` in `Brut::FrontEnd::Page`. This is why a page class must provide `page_template` instead.
+
+While you could override `view_template` in your page to provide a "blank layout",
+this is discouraged, as the use of `view_template` should be considered a
+private implementation detail.
+
+

data/brutrb.com/overview.md

@@ -24,18 +24,18 @@ the *server side*, however it exists to provide a user interface of some sort.
 * *Back End* is the code that deals with everything else, such as accessing a database, executing business logic, or managing background jobs.
 
 
-![Architectural Overview](/images/overview.png)
+![Architectural Overview](/images/OverviewMetro.png)
 
+* **Visitor** is someone visiting your web site or app.
 * **Browser** is, well, a web browser
 * [**Pages**](/pages) generate web pages, which is what happens when a browser's UI navigates to a URL.
+* [**Forms**](/forms) describe the inputs of an HTML `<form>` element, and hold a form's submitted data for server-side processing. Browser submit forms to the server.
 * [**Components**](/components) generate HTML fragments and are used to generate the HTML of a page or for re-use across pages.
-* [**Forms**](/forms) describe the inputs of an HTML `<form>` element, and hold a form's submitted data for server-side
-processing.
 * [**Handlers**](/handlers) receive non-GET HTTP requests from the browser, notably form submissions.
-* [**JS**](/javascript) and [**Assets**](/assets) (including [CSS](/css)) are bundled on the server and sent to the client.
+* [**JavaScript**](/javascript) and [**Assets**](/assets) (including [CSS](/css)) are bundled on the server and sent to the client.
+* [**Domain Logic**](/business-logic) as where your business and domain logic lives and can be implemented however you like.
 * [**DB Models**](/database-access) are objects that provide access to your database.
-* [**Domain Logic**](/business-logic) as where your business and domain logic lives and can be implemented
-however you like.
+* **Relational Database** is your database, where data is stored.
 
 ## Brut is Not a Resource-Oriented MVC Framework.
 

data/docker-compose.dx.yml

@@ -8,11 +8,14 @@ services:
         source: ${PWD}
         target: ${PWD}
         consistency: "consistent"
+      # This allows access to Git configuration so Git commands work
       - type: bind
         source: ${GIT_CONFIG}
-        target: "/root/.gitconfig"
-    entrypoint: /root/show-help-in-app-container-then-wait.sh
+        target: "/home/appuser/.gitconfig"
+    command: /home/appuser/show-help-in-app-container-then-wait.sh
     working_dir: ${PWD}
+    environment:
+      PROJECT_ROOT: ${PWD}
     ports:
       - "8086:8086"
       - "8087:8087"

data/docs/404.html

@@ -6,16 +6,16 @@
     <title>404 | Brut RB</title>
     <meta name="description" content="Not Found">
     <meta name="generator" content="VitePress v1.6.3">
-    <link rel="preload stylesheet" href="/assets/style.D73IYGCX.css" as="style">
+    <link rel="preload stylesheet" href="/assets/style.B2o1L9eN.css" as="style">
     <link rel="preload stylesheet" href="/vp-icons.css" as="style">
     
-    <script type="module" src="/assets/app.D_yaTITQ.js"></script>
+    <script type="module" src="/assets/app.BhrfSt68.js"></script>
     <script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
     <script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
   </head>
   <body>
     <div id="app"></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"ai.md\":\"tZrjP9im\",\"assets.md\":\"D3wunzLx\",\"brut-js.md\":\"o2DAO2s2\",\"business-logic.md\":\"BY4hGy0m\",\"cli.md\":\"RmeA2b0i\",\"components.md\":\"eCttGlN-\",\"configuration.md\":\"BRriU0cL\",\"css.md\":\"DJgj2clw\",\"custom-element-tests.md\":\"BrYJQEl3\",\"database-access.md\":\"C7l-Vuvb\",\"database-schema.md\":\"BUjR0VS1\",\"deployment.md\":\"Dbka4OTr\",\"dev-environment.md\":\"BNc8AYiK\",\"doc-conventions.md\":\"DCfRXXi-\",\"end-to-end-tests.md\":\"yfQHC0b5\",\"flash-and-session.md\":\"BXY8RvT0\",\"forms.md\":\"CBTYQ_Cz\",\"getting-started.md\":\"Bz2s1Vjb\",\"handlers.md\":\"089DVD3v\",\"hooks.md\":\"C4-moMny\",\"i18n.md\":\"Do9i1qWl\",\"index.md\":\"B28EwVpq\",\"instrumentation.md\":\"CL6ax7nT\",\"javascript.md\":\"GWbhRS51\",\"jobs.md\":\"S-2amAYp\",\"keyword-injection.md\":\"Dt2tKREs\",\"markdown-examples.md\":\"CCFEQO44\",\"middleware.md\":\"Czz_UlJN\",\"not-released.md\":\"BBy28McC\",\"overview.md\":\"CDalkuxV\",\"pages.md\":\"BE3kfOc5\",\"routes.md\":\"BMM7peut\",\"security.md\":\"C668yXCi\",\"seed-data.md\":\"BvFZlqIk\",\"space-time-continuum.md\":\"KPUIKysQ\",\"tutorial.md\":\"BnoGjrdK\",\"unit-tests.md\":\"DUGrnLj5\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":false,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"ai.md\":\"_6HCDL6d\",\"assets.md\":\"D3wunzLx\",\"brut-js.md\":\"o2DAO2s2\",\"business-logic.md\":\"BY4hGy0m\",\"cli.md\":\"RmeA2b0i\",\"components.md\":\"CRUMdRoN\",\"configuration.md\":\"LG-zIBww\",\"css.md\":\"DJgj2clw\",\"custom-element-tests.md\":\"BrYJQEl3\",\"database-access.md\":\"C7l-Vuvb\",\"database-schema.md\":\"BUjR0VS1\",\"deployment.md\":\"BLseERGV\",\"dev-environment.md\":\"GZv6xvi9\",\"doc-conventions.md\":\"-kN3Xo5C\",\"end-to-end-tests.md\":\"yfQHC0b5\",\"flash-and-session.md\":\"BXY8RvT0\",\"forms.md\":\"B-koVgyw\",\"getting-started.md\":\"Dj0qtZI2\",\"handlers.md\":\"089DVD3v\",\"hooks.md\":\"C4-moMny\",\"i18n.md\":\"Do9i1qWl\",\"index.md\":\"CuBB-BdM\",\"instrumentation.md\":\"a9Pjps4P\",\"javascript.md\":\"GWbhRS51\",\"jobs.md\":\"S-2amAYp\",\"keyword-injection.md\":\"Dt2tKREs\",\"layouts.md\":\"cPnh3NId\",\"lsp.md\":\"Bsu-f6VU\",\"markdown-examples.md\":\"CCFEQO44\",\"middleware.md\":\"Czz_UlJN\",\"not-released.md\":\"BBy28McC\",\"overview.md\":\"DVKRM8zl\",\"pages.md\":\"BE3kfOc5\",\"recipes_authentication.md\":\"CAsXf7hk\",\"routes.md\":\"BMM7peut\",\"security.md\":\"C668yXCi\",\"seed-data.md\":\"BvFZlqIk\",\"space-time-continuum.md\":\"KPUIKysQ\",\"tutorial.md\":\"BnoGjrdK\",\"unit-tests.md\":\"DUGrnLj5\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"en-US\",\"dir\":\"ltr\",\"title\":\"Brut RB\",\"description\":\"Documentation for the Brut.RB web framework.\",\"base\":\"/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"search\":{\"provider\":\"local\"},\"nav\":[{\"text\":\"Home\",\"link\":\"/\"},{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Overview\",\"link\":\"/overview\"},{\"text\":\"Brut API\",\"link\":\"/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js/api/index.html\",\"target\":\"_self\"},{\"text\":\"BrutCSS\",\"link\":\"/brut-css/index.html\",\"target\":\"_self\"}],\"outline\":[2,3],\"sidebar\":[{\"text\":\"Overview\",\"collapsed\":false,\"items\":[{\"text\":\"Getting Started\",\"link\":\"/getting-started\"},{\"text\":\"Concepts\",\"link\":\"/overview\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Handlers and Actions\",\"link\":\"/handlers\"},{\"text\":\"Components\",\"link\":\"/components\"},{\"text\":\"Flash and Session\",\"link\":\"/flash-and-session\"},{\"text\":\"Space/Time Continuum\",\"link\":\"/space-time-continuum\"},{\"text\":\"JavaScript\",\"link\":\"/javascript\"},{\"text\":\"CSS\",\"link\":\"/css\"},{\"text\":\"Assets\",\"link\":\"/assets\"},{\"text\":\"BrutJS\",\"link\":\"/brut-js\"}]},{\"text\":\"Back-End\",\"collapsed\":false,\"items\":[{\"text\":\"Database Schema\",\"link\":\"/database-schema\"},{\"text\":\"Database Access\",\"link\":\"/database-access\"},{\"text\":\"Seed Data\",\"link\":\"/seed-data\"},{\"text\":\"Jobs\",\"link\":\"/jobs\"},{\"text\":\"Business Logic\",\"link\":\"/business-logic\"}]},{\"text\":\"Framework\",\"collapsed\":false,\"items\":[{\"text\":\"Configuration\",\"link\":\"/configuration\"},{\"text\":\"Keyword Injection\",\"link\":\"/keyword-injection\"},{\"text\":\"I18n\",\"link\":\"/i18n\"},{\"text\":\"CLI / Tasks\",\"link\":\"/cli\"},{\"text\":\"Deployment\",\"link\":\"/deployment\"}]},{\"text\":\"Testing\",\"collapsed\":false,\"items\":[{\"text\":\"Unit Tests\",\"link\":\"/unit-tests\"},{\"text\":\"End-to-End Tests\",\"link\":\"/end-to-end-tests\"},{\"text\":\"Testing Custom Elements\",\"link\":\"/custom-element-tests\"}]},{\"text\":\"Advanced Topics\",\"collapsed\":true,\"items\":[{\"text\":\"Route Hooks\",\"link\":\"/hooks\"},{\"text\":\"Middleware\",\"link\":\"/middleware\"},{\"text\":\"Instrumentation\",\"link\":\"/instrumentation\"},{\"text\":\"Security\",\"link\":\"/security\"},{\"text\":\"LSP Support\",\"link\":\"/lsp\"}]},{\"text\":\"Recipes\",\"collapsed\":true,\"items\":[{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Form Validations\",\"link\":\"/recipes/form-validations\"},{\"text\":\"Database Migrations\",\"link\":\"/recipes/database-migrations\"},{\"text\":\"Ajax Form Submission\",\"link\":\"/recipes/ajax-form\"},{\"text\":\"Custom Telemetry\",\"link\":\"/recipes/telemetry\"},{\"text\":\"CLI App/Task\",\"link\":\"/recipes/cli-app\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
     
   </body>
 </html>