update docs

Author: tcurrent

README.md

@@ -17,11 +17,12 @@ npm start
 ## Core Commands
 
 ```bash
-npm start          # NODE_ENV=development, loads .env.development
-npm run start:prod # NODE_ENV=production, loads .env.production
-npm run build:css  # Build ui/dist/styles.css from ui/styles.css
-npm run db:migrate # Run migration scripts
-npm run db:seed    # Run migrations + seed scripts
-npm run db:reset   # Delete DB, then run migrations + seed scripts
-npm run build:docs # Local docs preview
+npm start               # NODE_ENV=development, loads .env.development
+npm run start:prod      # NODE_ENV=production, loads .env.production
+npm run build:css       # Build ui/dist/styles.css from ui/styles.css
+npm run db:migrate      # Run migration scripts
+npm run db:seed         # Run migrations + seed scripts
+npm run db:reset        # Delete DB, then run migrations + seed scripts
+npm run build:docs      # Local docs build
+npx serve .site         # Preview local docs after build (include -l flag and port if needed)
 ```

docs/getting-started.md

@@ -22,12 +22,14 @@ npm install
 ## Run Commands
 
 ```bash
-npm start          # NODE_ENV=development, loads .env.development
-npm run start:prod # NODE_ENV=production, loads .env.production
-npm run build:css  # build ui/dist/styles.css from ui/styles.css
-npm run db:migrate # run migration scripts
-npm run db:seed    # run migrations + seed scripts
-npm run db:reset   # delete DB, then run migrations + seed scripts
+npm start               # NODE_ENV=development, loads .env.development
+npm run start:prod      # NODE_ENV=production, loads .env.production
+npm run build:css       # Build ui/dist/styles.css from ui/styles.css
+npm run db:migrate      # Run migration scripts
+npm run db:seed         # Run migrations + seed scripts
+npm run db:reset        # Delete DB, then run migrations + seed scripts
+npm run build:docs      # Local docs build
+npx serve .site         # Preview local docs after build (include -l flag and port if needed)
 ```
 
 ## Environment Variables

scripts/build-docs-pages.js

@@ -123,7 +123,7 @@ const pageTemplate = ({ pageTitle, navItems, activeSlug, contentHtml }) => {
     </nav>
 
     <section class="section-card" aria-live="polite">
-      <div class="section-body">
+      <div class="section-body docs-section-body">
         <div class="markdown-content">${contentHtml}</div>
       </div>
     </section>

ui/dist/styles.css

@@ -1023,6 +1023,10 @@
     border-color: #2a2a2a;
     padding: calc(var(--spacing) * 3.5);
   }
+  .docs-section-body {
+    border-top-style: var(--tw-border-style);
+    border-top-width: 0px;
+  }
   .auth-card {
     margin-inline: auto;
     width: 100%;

ui/styles.css

@@ -270,6 +270,10 @@
     @apply border-t border-line p-3.5;
   }
 
+  .docs-section-body {
+    @apply border-t-0;
+  }
+
   .auth-card {
     @apply mx-auto w-full max-w-md;
   }