brut 0.15.0 → 0.16.0.pre

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b85e8f08f4b6505e4eb6b0eccf7954116e843e29a2fe44701510fb48a5453530
-  data.tar.gz: ee48f403522914288e3a6ee5a4c5182907da98102fe0080cd27a6afee4f63b33
+  metadata.gz: 98447eff97921a8aeb30a9ffa801452a97c8f46a6169e300f6792582c6af191c
+  data.tar.gz: 3040a27ce2283e967f0f0bac694cb0a4fcaa7c7c0bd1bb2c52246dea9dcc2ba5
 SHA512:
-  metadata.gz: 894635a9a6137e99a5b48726e8c57266835741682591ff1c8121b9fc9d68f3ce752172a403018e8b3d6d64ddac197ef4ed11a58da0fe5a3b9bbe49663f4053b7
-  data.tar.gz: 36d4f093177d2a0f79f698c46eb5615225cf59c82562f990ef102feb9e8bd54c7e2655cfed9b8eaa2af35a134f0510adc7b06a91262cfaacfccddb233588a561
+  metadata.gz: 834e282f6c08942742733de34e04b9b4ada8cf03bbff02b6604fe54a49af28d1fdebe9da173b852e49f29ab87562335495fc9b6846a0b3a6184aa833677908d1
+  data.tar.gz: 9d41d53d28c12e4d5a99ab81490f10c5e0ccb4f6158c1c1dee51ba5321e3d1e92c04e5e1d566815319dea20bc0071662da174c4d930e84d7a30510da1a382cca

data/.gitignore

@@ -31,6 +31,8 @@
 /brut-js/node_modules
 /brut-js/docs/node_modules
 /brut-css/node_modules
+# Configured location for npm install -g
+/.npm-global
 
 # This is where the bundle is built during testing for BuildJS
 /brut-js/specs/public/js

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Brut CHANGELOG
 
+## v0.16.0.pre - Sep 29, 2025
+
+* Sidekiq support - this may have some churn in various config files that only reveal themselves on deploy so this
+  is a pre-release. Do not use this version.
+
 ## v0.15.0 - Sep 16, 2025
 
 * Added `<brut-toast>` to help with toast notifications.  They rely on CSS for showing, hiding, and animations, all your

data/Dockerfile.dx

@@ -37,6 +37,9 @@ ENV EDITOR=vim
 RUN apt-get install -y vim && \
     echo "set -o vi" >> /root/.bashrc
 
+# Install NodeJS
+COPY --from=node:22-slim /usr/local /usr/local
+
 
 # Setup a non-root user
 
@@ -70,12 +73,6 @@ COPY --chown=appuser:${user_gid} dx/bash_customizations.local /home/appuser/.bas
 # ONLY in that group and not in all the groups in which they are a part.
 USER appuser
 
-# Install NodeJS, per https://nodejs.org/en/download
-RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash && \
-    \. "$HOME/.nvm/nvm.sh" && \
-    nvm install 22 && \
-    node -v && nvm current && npm -v
-
 # Node's colors are hand-crafted to always look bad and render at least some text unreadable 
 # no matter what your setup. Cool.
 ENV NODE_DISABLE_COLORS=1

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    brut (0.15.0)
+    brut (0.16.0.pre)
       concurrent-ruby
       i18n
       irb

data/brut-css/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "brut-css",
-  "version": "0.15.0",
+  "version": "0.16.0.pre",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "brut-css",
-      "version": "0.15.0",
+      "version": "0.16.0.pre",
       "license": "Hippocratic-2.1",
       "devDependencies": {
         "comment-parser": "^1.4.1",

data/brut-css/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brut-css",
-  "version": "0.15.0",
+  "version": "0.16.0.pre",
   "description": "Utility CSS Library for Full Stack Developers",
   "keywords": [
     "css"

data/brut-js/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "brut-js",
-  "version": "0.15.0",
+  "version": "0.16.0.pre",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "brut-js",
-      "version": "0.15.0",
+      "version": "0.16.0.pre",
       "license": "Hippocratic-2.1",
       "devDependencies": {
         "esbuild": "^0.24.2",

data/brut-js/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brut-js",
-  "version": "0.15.0",
+  "version": "0.16.0.pre",
   "type": "module",
   "keywords": [
     "WebComponents",

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

@@ -129,12 +129,13 @@ export default defineConfig({
         text: "Recipes",
         collapsed: true,
         items: [
-          { text: "Migration Basics", link: "/recipes/migrations" },
-          { text: "Styling Form Errors", link: "/recipes/form-errors" },
-          { text: "Authentication", link: "/recipes/authentication" },
           { text: "Alternate Layouts", link: "/recipes/alternate-layouts" },
+          { text: "Authentication", link: "/recipes/authentication" },
           { text: "Custom Flash Class", link: "/recipes/custom-flash" },
           { text: "Indexed Form Elements", link: "/recipes/indexed-forms" },
+          { text: "Managing Secrets in the Dev Environment", link: "/recipes/dev-env-secrets" },
+          { text: "Migration Basics", link: "/recipes/migrations" },
+          { text: "Styling Form Errors", link: "/recipes/form-errors" },
           { text: "Text Field Component", link: "/recipes/text-field-component" },
         ],
       },

data/brutrb.com/deployment.md

@@ -22,30 +22,45 @@ When creating your Brut app with `mkbrut`, the Heroku segment can be used to cre
 
 How to deploy:
 
-1. Auth to Heroku from inside your dev container:
+1. Get an auth token from Heroku, which you can do from inside the container, and save it to
+   `bash_customizations.local`:
 
    ```
    your-computer> dx/exec bash
    devcontainer> heroku auth:login
    # You will need to copy/paste the URL to log in
-   devcontainer> heroku container:login
+   devcontainer> heroku authorizations:create -d "container pushes" --expires-in 31536000
+   # Copy the token output by this command
+   devcontainer> echo "HEROKU_API_KEY=«TOKEN YOU COPIED»" >> dx/bash_customizations.local
    ```
+2. Exit the devcontainer and  stop `dx/start` (e.g. hit `Ctrl-C` wherever you ran it)
+3. Rebuild and restart the devcontainer (this will set `HEROKU_API_KEY` for you)
 
-2. Create your app using the container stack:
+   ```
+   your-computer> dx/build
+   your-computer> dx/start
+   # In another terminal window
+   your-computer> dx/exec bash
+   devcontainer> echo $HEROKU_API_KEY
+   # You should see the token
+   ```
+
+   Setting this environment variable avoids having to constantly re-authenticate to Heroku.
+
+4. Create your app using the container stack:
 
    ```
    > heroku create --stack container -a «your heroku app name»
    ```
-3. Ensure your app's source code is all checked in, there are no uncommitted or unadded files, and you have pushed to main.
-4. `bin/deploy`
+5. Ensure your app's source code is all checked in, there are no uncommitted or unadded files, and you have pushed to the `main` branch of your remote Git repository.
+6. `bin/deploy`
 
    This will generate a `Dockerfile` for each process (by default, `Dockerfile.web` and `Dockerfile.release`), build images, push those images to Heroku, and ask Heroku to release them.
 
 Debugging Tips:
 
-* Keep in mind it's hard to make general deployment tools. You are expected to understand your deployment and be capable of deploying an arbitrary Rack app manually.  Brut's tooling automates what you need to know.
-* `bin/deploy` runs the `deploy` subcommand, so `bin/deploy help deploy` can provide
-some options for debugging issues:
+* Keep in mind it's hard to make general deployment tools. You are expected to understand your deployment and be capable of deploying an arbitrary Rack app manually.  Brut's tooling automates what you need to do based on what you already need to know.
+* `bin/deploy` runs the `deploy` subcommand, so `bin/deploy help deploy` can provide some options for debugging issues:
 
   ```
   devcontainer> bin/deploy help deploy
@@ -106,7 +121,6 @@ some options for debugging issues:
   You'll need to have a better understanding of Docker to do this, however if you
   are deploying with Docker, this is an understanding you hopefully already have.
 
-
 ### Other Mechanisms for Deployment
 
 As a Rack app, other deployments should be possible.  To make the app work, you'll need to make sure a few things are dealt with:

data/brutrb.com/jobs.md

@@ -1,14 +1,114 @@
 # Background Jobs
 
-Brut provides little direct support for background jobs. Currently, Brut recommends Sidekiq, since it is
-battle-tested, well-supported, and open source.
+Brut ships without any background job system, however it should work with any system you'd like to use.  Brut
+can install/configure Sidekiq for you, however you are expected to understand Sidekiq in order to use it.
 
-When you set up your Brut app, it should ask if you want Sidekiq support and add the necessary configuraiton.
+## Setting up Sidekiq
 
-It will expect jobs in `app/src/back_end/jobs`.
+Brut's code-generation system used for installing capabilities are called *segments*, and Brut provides a
+Sidekiq segment you can use to get an initial working setup of Sidekiq in your Brut app.
 
-> [!WARNING]
-> The way Sidekiq is configured with Brut is effective and reliable, but it is complex.  It currently
-> involves several moving parts to make it work properly.  This will be an area for improvement.
+### Adding the Segment
 
+1. Ensure your project files are all committed. This is so you can easily see (and, if needed, undo) the
+   changes `mkbrut` will make.
+2. Use `mkbrut` to add the segment:
 
+   ```
+   docker run \
+          --pull always \
+          -v "$PWD":"$PWD" \
+          -w "$PWD" \
+          -u $(id -u):$(id -g) \
+          -it \
+          thirdtank/mkbrut \
+          mkbrut add-segment -r /path/to/your/project sidekiq
+   ```
+3. This will modify and create various files in your project. Check them out if you like:
+
+   ```
+   > git status
+   ```
+4. Exit your dev environment (i.e. hit `Ctrl-C` wherever you ran `dx/start`).
+5. Rebuild and restart your dev environment. This may take a moment, since Valkey will be downloaded.
+
+   ```
+   your-computer> dx/build
+   your-computer> dx/start
+   ```
+6. In another Terminal, connect to your dev container and run `bin/setup`
+
+   ```
+   your-computer> dx/exec bash
+   devcontainer> bin/setup
+   ```
+7. The segment provides an integration test that will use the actual Sidekiq server and client, running
+   against the actual Valkey database that was installed:
+
+   ```
+   devcontainer> bin/test e2e specs/integration/sidekiq_works.spec.rb
+   ```
+
+If this test passes, you are ready to go.
+
+### Using Sidekiq in Brut
+
+Jobs live in `app/src/back_end/jobs`, however this is just a convention and is not enforced - you can place a
+job anywhere that Zeitwerk will find the class.  Brut also provides basic configuration and a base job.
+
+| File | Purpose|
+|------|--------|
+| `app/config/sidekiq.yml` | Standard configuration for Sidekiq |
+| `app/src/back-end/jobs/app_job.r` | Base class for your jobs that includes `Sidekiq::Job` |
+| `app/src/back-end/segments/sidekiq_segment.rb` | Initial client and server configuration for Sidekiq (that you can't do with `sidekiq.yml`. This sets up basic observability for your jobs |
+
+### Accessing the Web UI
+
+The Sidekiq segment mounts the Sidekiq Web UI to your app inside `config.ru`:
+
+```ruby
+# ...
+map "/sidekiq" do
+  use Rack::Auth::Basic, "Sidekiq" do |username, password|
+    [username, password] == [ENV.fetch("SIDEKIQ_BASIC_AUTH_USER"), ENV.fetch("SIDEKIQ_BASIC_AUTH_PASSWORD")]
+  end
+  run Sidekiq::Web.new
+end
+# ...
+```
+
+Values for `SIDEKIQ_BASIC_AUTH_USER` and `SIDEKIQ_BASIC_AUTH_PASSWORD` for dev and test are placed into
+`.env.development` and `.env.test`, respectively. You must provide these values for production, based on
+however you are managing environment variables.
+
+Once you start the app, navigat to `http://localhost:6502/sidekiq` and enter the username/password from
+`.env.development`. You should see the web UI.
+
+### Deploying with The Heroku Segment
+
+If you have set up [Heroku Container-based Deployment](/deployment.md#heroku-container-based-deployment), you
+may need to modify `deploy/heroku_config.rb`.  The Sidekiq segement should have edited this, however if you
+installed the Heroku segment after setting up Sidekiq, you'll need to add to the file:
+
+```ruby [2-6]
+class HerokuConfig
+  def self.additional_images
+    {
+      "sidekiq" => {
+        cmd: "bin/run-sidekiq",
+      }
+    }
+  end
+end
+```
+
+## Setting Up Other Job Systems
+
+To use another job system, you'll likely want to start with `app/src/app.rb`.  You can place all your
+initialize code in `#boot!` to get things working, then factor it out from there.  `App`, the class in that
+file, is a normal class, so you can extract your setup to other normal classes and bring them in as you would
+in any other Ruby app.
+
+Just note that `App`'s `initialize` method should avoid making network connections, so while you are safe to
+create objects and configuration here, do not connect to databases or anything like that.  You *can* do that
+inside `boot!`.

data/brutrb.com/recipes/dev-env-secrets.md

@@ -0,0 +1,87 @@
+# Managing Secrets in the Dev Environment
+
+Often, you need API keys like GitHub or Heroku tokens in order to perform development tasks. These should not be checked into version
+control, however you can still manage them.
+
+## Feature - API Keys
+
+* Developers need do use the Heroku command-line app inside the dev container.
+* Develoeprs do not want to have to perform a daily, browser-based authentication via `heroku auth:login`
+
+### Recipe
+
+The file `dx/bash_customizations.local` is set up for exactly this.  It is not checked into version control (see your `.gitignore`), and it
+is included when the development environment is built.
+
+```bash
+# dx/bash_customizations.local
+HEROKU_API_KEY=xxxxxx
+```
+
+When you change this file, you must rebuild your dev environment:
+
+1. `Ctrl-C` wherever you ran `dx/start`
+2. `dx/build`
+3. `dx/start`
+4. `dx/exec bash`, then `bin/setup`, then continue where you left off
+
+#### How This Works
+
+Here is a snippet of how this works.  In the first `RUN` directlive, the non-root user is created. When that is completed, `~/.profile` and
+`~/.bashrc` are modified to source both `bash_customizations` (per-project customizations that should **not** contain secrets) and
+`bash_customizations.local`, which is the file we are discussing.
+
+After that, the files are copied into the image via the `COPY` directives.
+
+```dockerfile
+# Snippet from Dockerfile.dx
+RUN useradd --uid ${user_uid} --gid ${user_gid} --groups ${sadly_user_must_be_added_to_root}${docker_gid} --create-home --home-dir /home/appuser appuser && \
+    echo ". ~/.bash_customizations" >> /home/appuser/.profile && \
+    echo ". ~/.bash_customizations.local" >> /home/appuser/.profile && \
+    echo ". ~/.bash_customizations" >> /home/appuser/.bashrc && \
+    echo ". ~/.bash_customizations.local" >> /home/appuser/.bashrc
+
+COPY --chown=appuser:${user_gid} dx/show-help-in-app-container-then-wait.sh /home/appuser
+COPY --chown=appuser:${user_gid} dx/bash_customizations /home/appuser/.bash_customizations
+COPY --chown=appuser:${user_gid} dx/bash_customizations.local /home/appuser/.bash_customizations.local
+```
+
+> [!WARNING]
+> The resulting image **will** contain the secrets from `bash_customizations.local`, so it's
+> **very important** you never push that image to a regsitry.
+
+## Feature - SSH Keys
+
+* You need an SSH key in order to push to GitHub from the dev container
+* You do not want to creata new key every time
+
+### Recipe
+
+Ultimately, you want the SSH key to be copied into the container and set up as if you'd created the key there.  The recipe below is an
+example of how you could do this, and should demonstrate the various seams in Brut's dev environment to allow you to craft it how you like.
+
+1. Choose a directory in the project where each developer will store their keys. **This directory should be excluded from version control**
+
+   ```
+   mkdir dx/credentials
+   echo "/dx/credetials" >> .gitignore
+   ```
+
+2. Assuming you create an SSH key already, place `id_ed25519` (private key) and `id_ed25519.pub` (public key) into `dx/credentials`.
+3. Create `dx/credentials/known_hosts` using `id_ed25519.pub`:
+
+   ```
+   github.com ssh-ed25519 «key from id_ed25519.pub here»
+   ```
+4. Your dev container will have access to `dx/credentials` already, so you can use `bin/setup` to copy them to the right place. How
+   you do this depends on how complicated you want to get.  You can examine Brut's `bin/setup` to see how it manages it.  You will
+   see that ti uses `ssh-agent` to avoid requiring the passcode every time, and that it uses `chmod` to make sure the SSH
+   directories are the right permissions.
+
+> [!WARNING]
+> The resulting image **will** contain your SSH key, so it's
+> **very important** you never push that image to a regsitry.
+
+
+This recipe is scant on details, since each credential is highly specific. The key points to know are that you can store information in the
+project, but not checked in, then rely on that information being available to `bin/setup` inside the container.

data/brutrb.com/roadmap.md

@@ -5,10 +5,10 @@ call a 1.0 release.  Here are some ideas of what I think is needed:
 
 ## Better Dev Experience
 
+* The CLI apps are all shimmed in a wierd way, expecially `mkbrut`. They should be part of the gem.
 * The output of `bin/dev` isn't great.
 * otel-desktop-viewer is cool, but not the easiest to figure out issues as compred to good 'ole logging.
 * Error pages in the app are *really* bad.
-* CLI apps are OK, but could be fancier.
 
 ## More Tests
 
@@ -21,7 +21,7 @@ call a 1.0 release.  Here are some ideas of what I think is needed:
 
 ## More Complete Web Features
 
-* Content security policy doens't allow for hashes, which can be limiting in some situations. I want everyone to be running with a CSP, so it has to be configurable to some degree.
+* Content security policy is all or nothing. You can bring stuff in via CDN without disabling the feature entirely.  I want everyone using CSP, but it needs to be more configurable.
 * Websockets, server-push, etc. should be possible or at least have a recipe.
 * Learn more about importmaps.
 
@@ -50,8 +50,3 @@ Out of the box support for more deployment mechanism, at least:
 * A unified look and feel across the board
 * Get rid of VitePress for something less client-heavy, but still great
 * Dash-accessible API docs
-
-## Misc
-
-* More direct Sidekiq support
-

data/docs/404.html

@@ -9,7 +9,7 @@
     <link rel="preload stylesheet" href="/assets/style.B1z60PPQ.css" as="style">
     <link rel="preload stylesheet" href="/vp-icons.css" as="style">
     
-    <script type="module" src="/assets/app.B0X8upRm.js"></script>
+    <script type="module" src="/assets/app.Dm7v_ouO.js"></script>
     <link rel="icon" href="/favicon.ico">
     <meta property="og:title" content="BrutRB Documentation">
     <meta property="og:type" content="website">
@@ -20,7 +20,7 @@
   </head>
   <body>
     <div id="app"></div>
-    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"YglbWtQe\",\"ai.md\":\"ChLnvDAX\",\"assets.md\":\"BEF6Oz6K\",\"brut-js.md\":\"CbJAe2Ky\",\"business-logic.md\":\"DbuaOYGU\",\"cli.md\":\"DDMar_51\",\"components.md\":\"C6nWgDP0\",\"configuration.md\":\"CpbYHWPb\",\"css.md\":\"K5rOCOQY\",\"custom-element-tests.md\":\"DiLe-eFw\",\"database-access.md\":\"Dc8l2Plf\",\"database-schema.md\":\"BJ_JhXmO\",\"deployment.md\":\"C1u5ep0g\",\"dev-environment.md\":\"B1S9p5ZK\",\"dir-structure.md\":\"D1T2kGwj\",\"doc-conventions.md\":\"CDnWaEFg\",\"end-to-end-tests.md\":\"BJJdNDYL\",\"features.md\":\"BDWxnyNO\",\"flash-and-session.md\":\"CUsMxoNl\",\"form-constraints.md\":\"KlfXSKm2\",\"forms.md\":\"Bii91k3E\",\"getting-started.md\":\"ChAvueK7\",\"handlers.md\":\"C5tUwmmo\",\"hooks.md\":\"CoiYCKRc\",\"i18n.md\":\"DxkCKhUw\",\"index.md\":\"DnphWyQd\",\"instrumentation.md\":\"BcxjC4jd\",\"javascript.md\":\"D6fxhaQb\",\"jobs.md\":\"Bc7Y1YpK\",\"keyword-injection.md\":\"CqLnnzIz\",\"layouts.md\":\"HEbeK7Jr\",\"lsp.md\":\"bE9dW8n9\",\"markdown-examples.md\":\"BPmtHlc-\",\"middleware.md\":\"BhOIsg59\",\"overview.md\":\"BpWAgPFH\",\"pages.md\":\"B3sQXpEd\",\"recipes_alternate-layouts.md\":\"C1QzVkA7\",\"recipes_authentication.md\":\"CyvoIW82\",\"recipes_custom-flash.md\":\"6gFqf2uL\",\"recipes_form-errors.md\":\"B5ptSzMO\",\"recipes_indexed-forms.md\":\"BYYQGW2C\",\"recipes_migrations.md\":\"Cid7-3cu\",\"recipes_text-field-component.md\":\"VhOsCtKI\",\"roadmap.md\":\"CJsbUmK_\",\"routes.md\":\"C1dgIBtD\",\"security.md\":\"Jn4SY1uK\",\"seed-data.md\":\"UZW0WxYN\",\"space-time-continuum.md\":\"D9rYGDFH\",\"tutorial.md\":\"BX6f6l00\",\"tutorials_01-intro.md\":\"CzZ3kpF_\",\"tutorials_02-dialog.md\":\"De6iTsWX\",\"unit-tests.md\":\"vDsdBbO_\",\"why.md\":\"4WpxdrQ2\"}");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\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"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\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Styling Form Errors\",\"link\":\"/recipes/form-errors\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
+    <script>window.__VP_HASH_MAP__=JSON.parse("{\"adrs.md\":\"YglbWtQe\",\"ai.md\":\"ChLnvDAX\",\"assets.md\":\"BEF6Oz6K\",\"brut-js.md\":\"BMz0X1Rz\",\"business-logic.md\":\"DbuaOYGU\",\"cli.md\":\"DDMar_51\",\"components.md\":\"Dfd3w6UW\",\"configuration.md\":\"DTYoV2Ea\",\"css.md\":\"K5rOCOQY\",\"custom-element-tests.md\":\"DiLe-eFw\",\"database-access.md\":\"Dc8l2Plf\",\"database-schema.md\":\"BJ_JhXmO\",\"deployment.md\":\"C1u5ep0g\",\"dev-environment.md\":\"B1S9p5ZK\",\"dir-structure.md\":\"D1T2kGwj\",\"doc-conventions.md\":\"CDnWaEFg\",\"end-to-end-tests.md\":\"BJJdNDYL\",\"features.md\":\"BDWxnyNO\",\"flash-and-session.md\":\"CUsMxoNl\",\"form-constraints.md\":\"KlfXSKm2\",\"forms.md\":\"DEkmJUvb\",\"getting-started.md\":\"DO-4eoGW\",\"handlers.md\":\"C5tUwmmo\",\"hooks.md\":\"CoiYCKRc\",\"i18n.md\":\"DxkCKhUw\",\"index.md\":\"DnphWyQd\",\"instrumentation.md\":\"BcxjC4jd\",\"javascript.md\":\"D6fxhaQb\",\"jobs.md\":\"Bc7Y1YpK\",\"keyword-injection.md\":\"CqLnnzIz\",\"layouts.md\":\"HEbeK7Jr\",\"lsp.md\":\"bE9dW8n9\",\"markdown-examples.md\":\"BPmtHlc-\",\"middleware.md\":\"BhOIsg59\",\"overview.md\":\"BpWAgPFH\",\"pages.md\":\"B3sQXpEd\",\"recipes_alternate-layouts.md\":\"C1QzVkA7\",\"recipes_authentication.md\":\"CyvoIW82\",\"recipes_custom-flash.md\":\"6gFqf2uL\",\"recipes_form-errors.md\":\"B5ptSzMO\",\"recipes_indexed-forms.md\":\"BYYQGW2C\",\"recipes_migrations.md\":\"Cid7-3cu\",\"recipes_text-field-component.md\":\"VhOsCtKI\",\"roadmap.md\":\"CJsbUmK_\",\"routes.md\":\"C1dgIBtD\",\"security.md\":\"Jn4SY1uK\",\"seed-data.md\":\"UZW0WxYN\",\"space-time-continuum.md\":\"D9rYGDFH\",\"tutorial.md\":\"BX6f6l00\",\"tutorials_01-intro.md\":\"CzZ3kpF_\",\"tutorials_02-dialog.md\":\"D2vSjDVf\",\"unit-tests.md\":\"vDsdBbO_\",\"why.md\":\"4WpxdrQ2\"}");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\":\"Features\",\"link\":\"/features\"},{\"text\":\"Directory Structure\",\"link\":\"/dir-structure\"},{\"text\":\"Dev Environment\",\"link\":\"/dev-environment\"},{\"text\":\"Tutorial\",\"link\":\"/tutorial\"},{\"text\":\"Documentation Conventions\",\"link\":\"/doc-conventions\"}]},{\"text\":\"Front-End\",\"collapsed\":false,\"items\":[{\"text\":\"Routes\",\"link\":\"/routes\"},{\"text\":\"Pages\",\"link\":\"/pages\"},{\"text\":\"Layouts\",\"link\":\"/layouts\"},{\"text\":\"Forms\",\"link\":\"/forms\"},{\"text\":\"Form Constraints\",\"link\":\"/form-constraints\"},{\"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\":\"Migration Basics\",\"link\":\"/recipes/migrations\"},{\"text\":\"Styling Form Errors\",\"link\":\"/recipes/form-errors\"},{\"text\":\"Authentication\",\"link\":\"/recipes/authentication\"},{\"text\":\"Alternate Layouts\",\"link\":\"/recipes/alternate-layouts\"},{\"text\":\"Custom Flash Class\",\"link\":\"/recipes/custom-flash\"},{\"text\":\"Indexed Form Elements\",\"link\":\"/recipes/indexed-forms\"},{\"text\":\"Text Field Component\",\"link\":\"/recipes/text-field-component\"}]},{\"text\":\"Meta\",\"collapsed\":false,\"items\":[{\"text\":\"Why?!\",\"link\":\"/why\"},{\"text\":\"ADRs\",\"link\":\"/adrs\"},{\"text\":\"Roadmap to 1.0\",\"link\":\"/roadmap\"},{\"text\":\"AI Declaration\",\"link\":\"/ai\"}]}],\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/thirdtank/brut\"}]},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
     
   </body>
 </html>