From 459e1d81afef05a8d2c1e4d591f9cbb159194bcc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tom=C3=A1=C5=A1=20=C4=8Carneck=C3=BD?= <tomc@caurea.org>
Date: Sun, 18 Jan 2026 20:19:07 +0000
Subject: [PATCH] .

---
 README.md | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 264fbff..0591102 100644
--- a/README.md
+++ b/README.md
@@ -34,8 +34,8 @@ Setup
  └─ Environment         Run 'pnpx vercel env pull'
 
 Commands
-  pnpm                  # Manage Node.js dependencies
-  dev                   # Start the Next.js development server
+  pnpm install          # Install Node.js dependencies
+  pnpm run dev          # Start the Next.js development server
 ```
 
 ## Usage
@@ -54,10 +54,15 @@ inputs = {
 brief = shell-brief.lib.mkShellBrief {
   inherit pkgs;
 
+  # The banner is printed at the top of the brief.
+  # Use it to print a recognizable introduction for your project.
   banner = ''
     ${pkgs.figlet}/bin/figlet Example Project
   '';
 
+  # Setup steps that need to be completed to allow working on the project.
+  # Each condition is a shell expression that must evaluate to true.
+  # If it fails, the suggestion is shown to the user.
   setup = [
     {
       name = "Dependencies";
@@ -76,13 +81,15 @@ brief = shell-brief.lib.mkShellBrief {
     }
   ];
 
+  # Commands, tools, scripts that are important to be aware.
+  # These can be provided by the buildInputs, custom scripts, shell alias or through other means.
   commands = [
     {
       name = "pnpm";
       help = "Manage Node.js dependencies";
     }
     {
-      name = "dev";
+      name = "pnpm run dev";
       help = "Start the Next.js development server";
     }
   ];
-- 
2.51.2