brut 0.0.28 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0212844b1dd1d69682b3b4ec4ab2a9917087b3d931916e39d9ccf0239d6a2f9c'
-  data.tar.gz: 871a018ce32f9d1f556eef7950570c8a4dd072736be733e6a7a925e14a8c968c
+  metadata.gz: ac39a29b335413475986e02cf9baa658bc44fa2e67e6dbd60dfafa7e4b9c8a2f
+  data.tar.gz: 155a9b104168bd18fe08fd8286576d63305d243d6025a4a1fcbcf1611611a8ed
 SHA512:
-  metadata.gz: eb49d9e87e53893962c86e2a26ca54f8c82cc9a8fbbeac5e12e1d7aaa4b47cbb13de6ab9429779422a6bc075dd3f4499bf6b18accb7c7ff87943eb32afda0342
-  data.tar.gz: c8f56cb073d99b1b3f304afe2daf3839b6b2b39ebe492bde05f00037ebf448459049560d3b32707450b65e32916366ea766d57598752026d0c025d1db63d7fe7
+  metadata.gz: 6126e575575511de23bd9ffe1429f05fa017664c66f7de07fa93b000edfb4f4dfd7c619d76d02d28e69cb70bfe163c4023d7a79cc53e1e41e3a44b5882cd0fd8
+  data.tar.gz: d38e331cd221d1a3bbd666b83a0d3e2df5a17fd4cbdccc47da7ca0df484d8ff46fb91c2f159c9da4fefcb8c829b98a8de4a040f013676170befecc0bcc45c3d1

data/.gitignore

@@ -32,3 +32,9 @@
 /brut-css/dist
 # This is where the CSS lives temporarily while docs are being built
 /brut-css/src/docs/brut.css
+
+# Per-developer Bash customizations that could contain secrets
+/dx/bash_customizations.local
+
+# Gems are installed here for LSP convienience
+/local-gems

data/.projections.json

@@ -0,0 +1,10 @@
+{
+  "lib/*.rb": {
+    "alternate": "specs/{}.spec.rb",
+    "type": "source"
+  },
+  "specs/*.spec.rb": {
+    "alternate": "lib/{}.rb",
+    "type": "spec"
+  }
+}

data/.rspec

@@ -0,0 +1,3 @@
+-I specs
+--require spec_helper
+-P "specs/**/*.spec.rb"

data/Dockerfile.dx

@@ -10,28 +10,46 @@ RUN apt-get -y clean && \
     apt-get -y update && \
     apt-get install --quiet --yes ca-certificates curl gnupg rsync
 
-# Install NODE per https://github.com/nodesource/distributions?tab=readme-ov-file#using-debian-as-root-nodejs-22
-RUN curl -fsSL https://deb.nodesource.com/setup_22.x -o /tmp/nodesource_setup.sh && \
-    bash /tmp/nodesource_setup.sh && \
-    apt-get install -y nodejs
-
-# Install Postgres client per https://www.postgresql.org/download/linux/debian/ - note that the 
-# automated configuration doesn't work, I think because it assumes non-root.
-RUN apt-get -y install lsb-release && \
-    sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list' && \
-    wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | apt-key add - && \
-    apt-get update && \
-    apt-get -y install postgresql-client-16
-
 RUN echo "gem: --no-document" >> ~/.gemrc && \
     gem update --system && \
     gem install bundler
-
 # Need vim at all times
 ENV EDITOR=vim
 RUN apt-get install -y vim && \
     echo "set -o vi" >> /root/.bashrc
 
+
+# Setup a non-root user
+
+# Their user id, which ideally matches their user id on the host
+ARG user_uid=10001
+# Their group id, which ideally matches their group id on the host
+ARG user_gid=10002
+
+# Create the user's group ID if it does not exist
+RUN getent group ${user_gid} || groupadd --gid ${user_gid} appgroup
+# Create the user. Note that we put bash_customizations in both .profile and .bashrc
+# to increase the chances they are used when running bash in various configurations
+RUN useradd --uid ${user_uid} --gid ${user_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
+
+# NOT including the group here as that will place the user's environment
+# 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.0.28)
+    brut (0.1.0)
       concurrent-ruby
       i18n
       irb

data/README.md

@@ -3,6 +3,8 @@
 Brut is a way to make web apps with Ruby, captializing on the knowledge you have—HTTP, HTML, CSS, JavaScript, SQL—without requiring
 *too* much extra stuff to learn.
 
+![Brut Logo in the style of the Washington DC Metro.  It has the metro brown background with all text in white Helvetica.  Centered at the top is "BrutRB". Below that, in the style of metro stops is "Ruby", next to a red dot with "RB" in it, "HTML/CSS/JS" next to an orange dot with "WP" in it, "Phlex" next to a blue dot with "PL" in it, and "RSpec" next to a green dot with "RS" in it.](brutrb.com/images/LogoStop.png)
+
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -19,6 +21,26 @@ Or install it yourself as:
 
     $ gem install brut
 
+## Getting Started
+
+[Please note there is extensive documentation](https://brutrb.com), however to get started, you can use [mkbrut](https://github.com/thirdtank/mkrbut):
+
+```
+docker run --pull always \
+           -v "$PWD":"$PWD" \
+           -w "$PWD" 
+           -it \
+           thirdtank/mkbrut \
+           mkbrut your-new-app
+```
+
+If you have Ruby 3.4 installed somewhere, you can use this via RubyGems as well:
+
+```
+> gem install mkbrut
+> mkbrut your-new-app
+```
+
 ## Developing
 
 The dev environment is managed by Docker and you are encouraged to use this. It's set up so you can edit your code on your computer
@@ -45,6 +67,5 @@ with your editor, but all commands are run inside Docker, which should be more c
 
         dx/exec bin/setup --no-credentials
 
-   The `--no-credentials` means that you will not be able to push to GitHub or RubyGems from within the Docker container. This
-   ability is only needed by maintainers to push new versions of the gem. You can push to GitHub from your computer.
+   The `--no-credentials` means that you will not be able to push to GitHub or RubyGems from within the Docker container. This ability is only needed by maintainers to push new versions of the gem. You can push to GitHub from your computer.
 

data/bin/docs

@@ -14,14 +14,36 @@ OptionParser.new do |opts|
   end
 end.parse!
 
-public_dir = (Pathname(__FILE__).dirname / ".." / "brutrb.com" / "public" ).expand_path.to_s
-docs_dir   =  public_dir + "/api"
+public_dir = (Pathname(__FILE__).dirname / ".." / "brutrb.com" / "public" ).expand_path
+docs_dir   =  public_dir / "api"
 brutjs_dir = (Pathname(__FILE__).dirname / ".." / "brut-js" ).expand_path.to_s
 
 system(
   "bundle exec yard doc -o '#{docs_dir}' -m markdown -M rdiscount --backtrace"
 )
 
+puts "Hacking CSS"
+[
+  docs_dir /  "css" / "style.css",
+  docs_dir /  "css" / "full_list.css"
+].each do |css_file_to_hack|
+  lines = File.read(css_file_to_hack).split(/\n/)
+  File.open(css_file_to_hack, "w") do |f|
+    lines.each do |line|
+      if line =~ /\"Lucida Sans"/
+        f.puts line.gsub(/\"Lucida Sans\"/, '"Helvetica Neue", "Lucida Sans"')
+      elsif line =~ / Monaco,/
+        f.puts line.gsub(/ Monaco,/, '"Courier New", Monaco,')
+      elsif line =~ /font-family: monospace;/
+        f.puts line.gsub(/font-family: monospace;/, 'font-family: "Courier New", monospace;')
+      else
+        f.puts line
+      end
+    end
+    f.puts "code { font-family: 'Courier New', monospace; font-weight: 600; }"
+  end
+end
+
 FileUtils.chdir brutjs_dir do
   system("bin/build")
 end

data/bin/rspec

@@ -0,0 +1,27 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+bundle_binstub = File.expand_path("bundle", __dir__)
+
+if File.file?(bundle_binstub)
+  if File.read(bundle_binstub, 300).include?("This file was generated by Bundler")
+    load(bundle_binstub)
+  else
+    abort("Your `bin/bundle` was not generated by Bundler, so this binstub cannot run.
+Replace `bin/bundle` by running `bundle binstubs bundler --force`, then run this command again.")
+  end
+end
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("rspec-core", "rspec")

data/bin/setup

@@ -83,7 +83,7 @@ def setup(update_gems:,setup_credentials:)
       system! "ssh-add #{key_file}"
     end
 
-    known_hosts_dest = Pathname("/") / "root" / ".ssh" / "known_hosts"
+    known_hosts_dest = Pathname("/") / "home" / "appuser" / ".ssh" / "known_hosts"
     if known_hosts_dest.exist?
       log "#{known_hosts_dest} exists, your ssh key should work with GitHub"
     else
@@ -117,7 +117,7 @@ def setup(update_gems:,setup_credentials:)
     end
     log "Your ssh key looks good"
 
-    gem_credentials_dest = Pathname("/") / "root" / ".gem" / "credentials"
+    gem_credentials_dest = Pathname("/") / "home" / "appuser" / ".gem" / "credentials"
     if gem_credentials_dest.exist?
       log "Gem credentials look good"
     else
@@ -139,7 +139,7 @@ def setup(update_gems:,setup_credentials:)
       end
     end
 
-    npm_credentials_dest = Pathname("/") / "root" / ".npmrc"
+    npm_credentials_dest = Pathname("/") / "home" / "appuser" / ".npmrc"
     if npm_credentials_dest.exist?
       log "NPM credentials look good"
     else

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

@@ -6,6 +6,33 @@ import jsdocLinker from './plugins/jsdocLinker'
 export default defineConfig({
   title: "Brut RB",
   description: "Documentation for the Brut.RB web framework.",
+  head: [
+    ["link", { rel: "icon", href: "/favicon.ico" }],
+    [
+      "meta", {
+        property: "og:title",
+        content: "BrutRB Documentation"
+      }
+    ],
+    [
+      "meta", {
+        property: "og:type",
+        content: "website"
+      }
+    ],
+    [
+      "meta", {
+        property: "og:image",
+        content: "https://github.com/thirdtank/brut/blob/main/assets/SocialImage.png?raw=true"
+      }
+    ],
+    ["script", {
+      defer: "",
+      "data-domain": "brutrb.com",
+      src: "https://plausible.io/js/script.js"
+    }
+    ],
+  ],
   themeConfig: {
     // https://vitepress.dev/reference/default-theme-config
     search: {
@@ -27,10 +54,11 @@ export default defineConfig({
         items: [
           { text: "Getting Started", link: "/getting-started" },
           { text: "Concepts", link: "/overview" },
-          { text: "Documentation Conventions", link: "/doc-conventions" },
-          { text: "Tutorial", link: "/tutorial" },
+          { text: "Features", link: "/features" },
+          { text: "Directory Structure", link: "/dir-structure" },
           { text: "Dev Environment", link: "/dev-environment" },
-          { text: "AI Declaration", link: "/ai" },
+          { text: "Tutorial", link: "/tutorial" },
+          { text: "Documentation Conventions", link: "/doc-conventions" },
         ]
       },
       {
@@ -41,6 +69,7 @@ export default defineConfig({
           { 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" },
@@ -98,12 +127,20 @@ export default defineConfig({
         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" },
+          { text: "Alternate Layouts", link: "/recipes/alternate-layouts" },
+          { text: "Blank Layouts", link: "/recipes/blank-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: "AI Declaration", link: "/ai" },
+        ]
       }
     ],
 

data/brutrb.com/.vitepress/theme/custom.css

@@ -5,3 +5,10 @@
 .image-bg {
   display: none;
 }
+td > code {
+  white-space: nowrap;
+}
+
+.VPHero img, .VPHome img {
+  border-radius: 0.5rem;
+}

data/brutrb.com/.vitepress/theme/style.css

@@ -44,6 +44,7 @@
  * -------------------------------------------------------------------------- */
 
 :root {
+  --vp-c-text-1: #362400;
   --vp-c-default-1: var(--vp-c-gray-1);
   --vp-c-default-2: var(--vp-c-gray-2);
   --vp-c-default-3: var(--vp-c-gray-3);
@@ -51,13 +52,14 @@
 
   --blue-vp-c-brand-1: #0C00A7;
   --blue-vp-c-brand-2: #6357FF;
-  --blue-vp-c-brand-3: #1000E2;
-  --blue-vp-c-brand-soft: #FAF9FF;
+  --blue-vp-c-brand-3: #4C0606;
+  --blue-vp-c-brand-soft: #FFF9F9;
+
+  --vp-c-brand-1: #001842;
+  --vp-c-brand-2: #6B84B1;
+  --vp-c-brand-3: #0443B1;
+  --vp-c-brand-soft: #FFF1D6;
 
-  --vp-c-brand-1: #A70C00;
-  --vp-c-brand-2: #FF6357;
-  --vp-c-brand-3: #e21000;
-  --vp-c-brand-soft: #FFE7E5;
 
   --xvp-c-brand-1: var(--vp-c-indigo-1);
   --xvp-c-brand-2: var(--vp-c-indigo-2);
@@ -69,15 +71,25 @@
   --vp-c-tip-3: var(--vp-c-brand-3);
   --vp-c-tip-soft: var(--vp-c-brand-soft);
 
-  --vp-c-warning-1: var(--vp-c-yellow-1);
-  --vp-c-warning-2: var(--vp-c-yellow-2);
-  --vp-c-warning-3: var(--vp-c-yellow-3);
-  --vp-c-warning-soft: var(--vp-c-yellow-soft);
-
-  --vp-c-danger-1: var(--vp-c-red-1);
-  --vp-c-danger-2: var(--vp-c-red-2);
-  --vp-c-danger-3: var(--vp-c-red-3);
-  --vp-c-danger-soft: var(--vp-c-red-soft);
+  --xvp-c-warning-1: var(--vp-c-yellow-1);
+  --xvp-c-warning-2: var(--vp-c-yellow-2);
+  --xvp-c-warning-3: var(--vp-c-yellow-3);
+  --xvp-c-warning-soft: var(--vp-c-yellow-soft);
+
+  --vp-c-warning-1: #9E5601;
+  --vp-c-warning-2: #FDAF53;
+  --vp-c-warning-3: #5E3301;
+  --vp-c-warning-soft: #FFF3E5;
+
+  --vp-c-danger-1: #AC0E0E;
+  --vp-c-danger-2: #F14E4E;
+  --vp-c-danger-3: #4C0606;
+  --vp-c-danger-soft: #FFF9F9;
+
+  --xvp-c-danger-1: var(--vp-c-red-1);
+  --xvp-c-danger-2: var(--vp-c-red-2);
+  --xvp-c-danger-3: var(--vp-c-red-3);
+  --xvp-c-danger-soft: var(--vp-c-red-soft);
 }
 
 /**
@@ -104,8 +116,8 @@
   --vp-home-hero-name-color: transparent;
   --vp-home-hero-name-background: -webkit-linear-gradient(
     120deg,
-    #333333 30%,
-    #d14141
+    #D67402 20%,
+    #11AC0E
   );
 
   --vp-home-hero-image-background-image: linear-gradient(

data/brutrb.com/ai.md

@@ -52,22 +52,17 @@ documentation, is produced by a machine, although spelling and grammar correctio
 
 We expect an LLM to be able to digest this documentation and source code and provide alternate analysis of how Brut works and how to use it.  We hope such analysis is correct and useful, however that cannot be guaranteed, so this documentation is the second best source of truth, the source code being the best.
 
-## Logo
+## Logos
 
-The logo is level 4 - ChatGPT created it. I'd love to have a real person make a better one.  I just needed
-something to get this launched.  Please reach out if you want to make a better one + other assets. I'm
-willing to pay a real person.
+While the various logos look like someone typed "make me a logo in the style of the Washington, DC Metro", if you look closely, you will see the telltale sings that they were made by a person…a person who is not a professional designer.
 
-## AI Completions Should Be Viewed with Skepticism
+As such, these are all Level 1.
 
-Due to how LLMs work, there is naturally nothing in any model about Brut.  Anything an
-existing model tells you about Brut is **100% untrustworthy**.  We hope to allow LLMs to consume Brut's
-code, documentation, and examples, so it can be an additional source of help, but currently that is not
-the case.
+## AI Information about Brut Should Be Viewed with Skepticism
 
-**Do not ask an LLM about Brut** until this part of the documentation changes.
-
-For completion-based AI suggestions, **view them with skepticism**.  In my
-experience, completions from e.g. GitHub CoPilot work OK when replicating a pattern
-in the file you are editing, but suggestions in a freshly-opened file tend to be
-entirely imaginary or Rails-based.  Beware.
+* **Answers from an LLM about Brut are likely incorrect.** LLMs will certainly not
+have been trained on information about Brut, since it is new.
+* **Code Completions of Brut Code are suspect.** I have observed that e.g. GitHub
+CoPilot is capable for properly completing Brut code if there is enough context, but
+it is not capable of, say, creating a component from scratch. **Review all Code
+Completions Carefully**.

data/brutrb.com/assets.md

@@ -46,14 +46,7 @@ JavaScript is on line 1 of `app.js`.  This is not helpful for diagnosing issues.
 *SourceMaps* are separate files that translate the minified files back to normal ones, so you can see a normal
 stack trace with the actual line numbers of your source files.
 
-There are many ways to create source maps and if you've used a tool like WebPack, you'll recall that many of them
-don't produce usable source maps.  Brut uses esbuild's facility for this, with a focus on correctness. When
-you see a line number and a source file in your browser, you can be sure it's accurate.
-
-The tradeoff is that it can take longer to produce than producing an inaccurate one. I'm not sure who wants
-inaccurate source maps, but Brut does not support this. In practice, esbuild is quite fast, so it should not make
-a practical difference in your day to day work.
-
+Brut's configuration of esbuild is to produce sourcemaps.
 
 ## Fonts
 
@@ -93,7 +86,7 @@ end
 ## SVGs
 
 You can place `.svg` files in `app/src/front_end/images` if you wish to use them in `<img>` tags.  However, if
-you place svgs in `app/src/front_end/svgs`, they can be inlined into your HTML via `inline_svg`.  In this case,
+you place svgs in `app/src/front_end/svgs`, they can be inlined into your HTML via `inline_svg`, provided by `Brut::FrontEnd::Component::Helpers` and included in all components and pages.  In this case,
 there is no need for a build step, since the SVG source is included directly in your HTML. This works well
 for icons.
 

data/brutrb.com/brut-js.md

@@ -73,7 +73,7 @@ improvements):
 * Default implementations of `connectedCallback` and `attributeChangedCallback` that call the template method `update`, thus allowing your element to centralize its logic in one place, regardless of how a state change was triggered.
 * Static `define()` method that defines your element based on its static `tagName` field. This allows richer interaction of elements, as you can do e.g. `document.querySelector(SomeOtherElement.tagName)`  and better navigate changes to your code over time.
 
-If you are familiary with the API for autonomous custom elements, `BaseCustomElement` doesn't require
+If you are familiar with the API for autonomous custom elements, `BaseCustomElement` doesn't require
 learning much more.  What you know already will be leveraged.
 
 ### Removing BrutJS
@@ -81,10 +81,20 @@ learning much more.  What you know already will be leveraged.
 To remove BrutJS from your app, modify `app/src/front_end/js/index.js` to remove the `import` and call to
 `define()`.  You can then remove it from your `package.json`.
 
-**Note** If you remove it like this, several features will not work, including locale detection, client-side observability, and client-side form validation UX.
+> [!NOTE]
+> If you remove it like this, several features will not work, including locale detection, client-side observability, and client-side form validation UX.
 
 ## Recommnded Practices
 
+### Leaving BrutJS In Your App
+
+BrutJS provides useful tools unrelated to single-page apps, or reactivity, or
+whatever else you might be concerned with in your client-side code.  These features
+can work alongside whatever framework you want to use. Leave them in unless they are
+causing a specific problem.
+
+### You Probably Don't Need a Single-Page App
+
 Consider this decision tree from Alex Russell's [If Not React, Then
 What?](https://infrequently.org/2024/11/if-not-react-then-what/):
 

data/brutrb.com/cli.md

@@ -117,7 +117,7 @@ All of this means that the bulk of CLI-specific code you will write is specifyin
 
 Every CLI app is a class that extends `Brut::CLI::App`. This class should contain one inner class for each subcommand. Those classes should extend `Brut::CLI::App`.
 
-Inside your `Brut::CLI::App` class, you can call a few class methods to declare aspects of the UI. In particular, `opts` returns the `OptionParser` in play that you can use to declare global options.  Unlike `OptionParser`'s `on` method, Brut's does not require providing a block. Brut will store the runtime options in a hash (see below).
+Inside your `Brut::CLI::App` class, you can call a few class methods to declare aspects of the UI. In particular, `opts` returns the `OptionParser` in play that you can use to declare global options.  Unlike `OptionParser`'s `on` method, Brut's does not require providing a block. Brut will store the runtime options in an object (see below).
 
 ```ruby
 class MyAppCLI < Brut::CLI::App
@@ -132,7 +132,7 @@ This code means your app's global options are `--dry-run`, which will not accept
 
 Declaring subcommands provides a similar API.  Let's say our app has a "status" subcommand, and a "run" subcommand.
 
-```ruby
+```ruby {7-11,13-16}
 class MyAppCLI < Brut::CLI::App
   description "My awesome command line app"
 
@@ -189,7 +189,7 @@ end
 
 ### Implementing `execute`
 
-Once `execute` is called, your app's internals will have been setup and bootstrapped. That means all you data models can access the database, and any other setup will have ocurred. Generally, `execute` can then have whatever code makes sense.
+Once `execute` is called, your app's internals will have been setup and bootstrapped. That means all your data models can access the database, and any other setup will have ocurred. Generally, `execute` can then have whatever code makes sense.
 
 That said, `execute` has access to a few values to understand the command line invocation and to support testing.
 
@@ -220,23 +220,19 @@ use that affect its behavior.
 
 Currently, Brut doesn't provide a way to create this file, but it's relatively straightforward.  It's almost entirely boilerplate except for your class:
 
-```ruby {14}
+```ruby {9}
 #!/usr/bin/env ruby
 
 require "bundler"
 Bundler.require
 require "pathname"
-
-require "brut/cli"
-
-APP_PATH = File.join(File.dirname($0),"..","app","src")
-$: << APP_PATH
-require "cli/my_app"
+require "brut/cli/apps/db"
 
 exit Brut::CLI.app(
-  MyAppCLI,
-  project_root: Pathname($0).dirname / ".."
-)
+      Brut::CLI::Apps::DB,
+      project_root: Pathname($0).dirname / ".."
+     )
+
 ```
 
 ## Testing