brut 0.0.27 → 0.0.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ad36cf0ea0c628d6ab48dafc53dfb9253f19ac5df73669e86532970ea70e759d
-  data.tar.gz: fa4dcb2b80e205fb2de2372fe8cfdfd441b6634ab69458287e41f5e681cc507f
+  metadata.gz: '0212844b1dd1d69682b3b4ec4ab2a9917087b3d931916e39d9ccf0239d6a2f9c'
+  data.tar.gz: 871a018ce32f9d1f556eef7950570c8a4dd072736be733e6a7a925e14a8c968c
 SHA512:
-  metadata.gz: a357cccfd1224fcd00d7909670d026a532c1d8cdc0bdd2549a92fad1621370bbdcde707b8fdab0c003ddbe71728018aef2c45201194614025f1b97520775847e
-  data.tar.gz: 042fc9088726c05c0f12b573f54eeb2d7ace79a4552a5756170fb776eaddf5ad895d2a702f1b2e5f05d94f5ff07b7ca4b560e9c3729153441458aa6c3c8e2340
+  metadata.gz: eb49d9e87e53893962c86e2a26ca54f8c82cc9a8fbbeac5e12e1d7aaa4b47cbb13de6ab9429779422a6bc075dd3f4499bf6b18accb7c7ff87943eb32afda0342
+  data.tar.gz: c8f56cb073d99b1b3f304afe2daf3839b6b2b39ebe492bde05f00037ebf448459049560d3b32707450b65e32916366ea766d57598752026d0c025d1db63d7fe7

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brut (0.0.27)
+    brut (0.0.28)
       concurrent-ruby
       i18n
       irb

data/brutrb.com/.vitepress/config.mjs

@@ -39,6 +39,7 @@ export default defineConfig({
         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" },

data/brutrb.com/dev-environment.md

@@ -137,16 +137,17 @@ that the versions of these command line apps provided when you set up your app a
 While you are free to set up mise or rbenv or whatever to run all this on your computer, this way of
 working is currently not supported nor encouraged.  For now, Brut will focus on the Docker-based approach.
 
-You are encouraged to understand how it works, especially because the Docker skills you learn in doing so
-will help with production deployment and operations.
+The primary reason is that it's a tightly controlled environment that is almost
+entirely scriptable, but does not require devs to abandon their preffered editor.
+Environment manager-based approaches tend to be more fussy and require documentation
+to ensure they are set up.
 
-Beyond this, we recommend that you keep a few things in mind with respect to automation:
+Keep in mind a few things when adding your own automation:
 
 * The *Foundational Core* is bootstrapped in a degenerate environment without reliable tools beyond Bash.
 This is why it's almost entirely written in Bash, since it's available everywhere and relatively stable.
 * The *Workspace* **can and should** rely on the languages and third party modules that are part of your
-app. Just keep in mind that `bin/setup` can only rely on programming language runtimes and not any
-particular Ruby gem having been installed.
+app. The only exception is `bin/setup`, since it installs third party modules.  As such, it should work entirely based on Ruby and its standard library.
 
 ## Technical Notes
 

data/brutrb.com/doc-conventions.md

@@ -6,7 +6,7 @@ Brut attempts to use existing terminology where possible, particularly where tha
 
 When speaking about Ruby, we prefer the term *initializer* over constructor, *parameters* over arguments, and *methods* over messages.  We also prefer *tests* over specs, however test files *are* located in `specs/` and named `*.spec.rb` to be consistent with RSpec's nomenclature.  We prefer *end-to-end* or *e2e* tests instead of browser tests or request specs. 
 
-Further, Brut doesn't render HTML, it *generates* it.  The browser renders the HTML for the website's visitor.
+Further, Brut doesn't render HTML, it *generates* it.  The browser renders the HTML for the website's visitor. One exception is Phlex, which uses the term *render* to mean "generate HTML to an internal buffer that will be delivered to the client later".  Thus, you will need to call Phlex's `render` method from time to time, even though it is not rendering HTML but helping to generate it.
 
 Lastly, the documentation tries to talk about the person accessing a website as a "vistor" not a "user". Though the "user" nomenclature is near-ossified in software development, we feel "visitor" is more apt.
 

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/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/docs/404.html

@@ -9,13 +9,13 @@
     <link rel="preload stylesheet" href="/assets/style.D73IYGCX.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.BX81XO4N.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\":\"BGHl8oRC\",\"css.md\":\"DJgj2clw\",\"custom-element-tests.md\":\"BrYJQEl3\",\"database-access.md\":\"C7l-Vuvb\",\"database-schema.md\":\"BUjR0VS1\",\"deployment.md\":\"Dbka4OTr\",\"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\":\"Ciz82L0m\",\"handlers.md\":\"089DVD3v\",\"hooks.md\":\"C4-moMny\",\"i18n.md\":\"Do9i1qWl\",\"index.md\":\"B28EwVpq\",\"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\":\"C5wlBcR5\",\"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>