Update site from docs source repo

Author: Exploding Labs Bot

superstack/gettingstarted/index.html

@@ -164,11 +164,29 @@
     </label>
 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix="">
 <li class="md-nav__item">
-<a class="md-nav__link" href="#1-clone-superstack">
+<a class="md-nav__link" href="#1-get-superstack">
 <span class="md-ellipsis">
-      1. Clone SuperStack
+      1. Get SuperStack
     </span>
 </a>
+<nav aria-label="1. Get SuperStack" class="md-nav">
+<ul class="md-nav__list">
+<li class="md-nav__item">
+<a class="md-nav__link" href="#option-1-use-the-template-recommended">
+<span class="md-ellipsis">
+      Option 1: Use the Template (Recommended)
+    </span>
+</a>
+</li>
+<li class="md-nav__item">
+<a class="md-nav__link" href="#option-2-clone-and-track-upstream-advanced">
+<span class="md-ellipsis">
+      Option 2: Clone and Track Upstream (Advanced)
+    </span>
+</a>
+</li>
+</ul>
+</nav>
 </li>
 <li class="md-nav__item">
 <a class="md-nav__link" href="#2-configure-environment-variables">
@@ -322,12 +340,30 @@
     </label>
 <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix="">
 <li class="md-nav__item">
-<a class="md-nav__link" href="#1-clone-superstack">
+<a class="md-nav__link" href="#1-get-superstack">
+<span class="md-ellipsis">
+      1. Get SuperStack
+    </span>
+</a>
+<nav aria-label="1. Get SuperStack" class="md-nav">
+<ul class="md-nav__list">
+<li class="md-nav__item">
+<a class="md-nav__link" href="#option-1-use-the-template-recommended">
+<span class="md-ellipsis">
+      Option 1: Use the Template (Recommended)
+    </span>
+</a>
+</li>
+<li class="md-nav__item">
+<a class="md-nav__link" href="#option-2-clone-and-track-upstream-advanced">
 <span class="md-ellipsis">
-      1. Clone SuperStack
+      Option 2: Clone and Track Upstream (Advanced)
     </span>
 </a>
 </li>
+</ul>
+</nav>
+</li>
 <li class="md-nav__item">
 <a class="md-nav__link" href="#2-configure-environment-variables">
 <span class="md-ellipsis">
@@ -380,48 +416,35 @@
 <h1 id="getting-started">🚀 Getting Started</h1>
 <p>SuperStack uses Docker, so make sure <a href="https://docs.docker.com/get-docker/">Docker is
 installed</a> before you begin.</p>
-<h2 id="1-clone-superstack">1. Clone SuperStack</h2>
-<div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/explodinglabs/superstack<span class="w"> </span>myapp
+<h2 id="1-get-superstack">1. Get SuperStack</h2>
+<h3 id="option-1-use-the-template-recommended">Option 1: Use the Template (Recommended)</h3>
+<p>The easiest way to get started:</p>
+<ol>
+<li>Click <a href="https://github.com/explodinglabs/superstack/generate">Use this
+   template</a> on GitHub.</li>
+<li>Create a new repository (e.g. <code>myapp</code>) from the template.</li>
+<li>Clone it to your machine:</li>
+</ol>
+<div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/yourname/myapp.git
 <span class="nb">cd</span><span class="w"> </span>myapp
 </code></pre></div>
-<details>
-<summary>
-  Recommended: Change the clone to point to your own hosted repository.
-</summary>
-
-Rename "origin" to "upstream":
-
-<div class="highlight"><pre><span></span><code>git<span class="w"> </span>remote<span class="w"> </span>rename<span class="w"> </span>origin<span class="w"> </span>upstream
+<h3 id="option-2-clone-and-track-upstream-advanced">Option 2: Clone and Track Upstream (Advanced)</h3>
+<p>If you want to keep SuperStack’s Git history and pull upstream changes later:</p>
+<div class="highlight"><pre><span></span><code>git<span class="w"> </span>clone<span class="w"> </span>https://github.com/explodinglabs/superstack.git<span class="w"> </span>myapp
+<span class="nb">cd</span><span class="w"> </span>myapp
+git<span class="w"> </span>remote<span class="w"> </span>rename<span class="w"> </span>origin<span class="w"> </span>upstream
+git<span class="w"> </span>remote<span class="w"> </span>add<span class="w"> </span>origin<span class="w"> </span>https://github.com/yourname/myapp
 </code></pre></div>
-
-This way you can still upgrade to a more recent SuperStack with:
-
+<p>You can now pull upstream changes with:</p>
 <div class="highlight"><pre><span></span><code>git<span class="w"> </span>pull<span class="w"> </span>upstream<span class="w"> </span>main
 </code></pre></div>
-
-Add your own code repository:
-
-<div class="highlight"><pre><span></span><code>git<span class="w"> </span>remote<span class="w"> </span>add<span class="w"> </span>origin<span class="w"> </span>https://github.com/yourname/myapp
-</code></pre></div>
-
-Now you can pull/push to your own repo as normal:
-
-<h3>Why not just fork SuperStack?</h3>
-
-Because you can't make a fork private.
-
-<h3>Why not make SuperStack a template repo?</h3>
-
-Because then you can't pull from upstream SuperStack.
-
-</details>
 <h2 id="2-configure-environment-variables">2. Configure Environment Variables</h2>
 <p>Copy the example file:</p>
 <div class="highlight"><pre><span></span><code>cp<span class="w"> </span>example.env<span class="w"> </span>.env
 </code></pre></div>
 <blockquote>
-<p>⚠️ The <code>.env</code> file is for local development only, don't write secrets to a
-file on other environments.</p>
+<p>⚠️ <strong>The .env file is for local development only.</strong> Don't store real secrets
+in production — use CI/CD environment variables or a secrets manager.</p>
 </blockquote>
 <h2 id="3-start-the-stack">3. Start the Stack</h2>
 <div class="highlight"><pre><span></span><code>docker<span class="w"> </span>compose<span class="w"> </span>up<span class="w"> </span>-d

superstack/index.html

@@ -323,9 +323,9 @@
 </li>
 
         <li class="md-nav__item">
-  <a href="#documentation" class="md-nav__link">
+  <a href="#get-started" class="md-nav__link">
     <span class="md-ellipsis">
-      📚 Documentation
+      📚 Get Started
     </span>
   </a>
 
@@ -648,9 +648,9 @@
 </li>
 
         <li class="md-nav__item">
-  <a href="#documentation" class="md-nav__link">
+  <a href="#get-started" class="md-nav__link">
     <span class="md-ellipsis">
-      📚 Documentation
+      📚 Get Started
     </span>
   </a>
 
@@ -694,15 +694,8 @@ <h2 id="what-can-i-do-with-superstack">🚀 What Can I Do with SuperStack?</h2>
 <p>Everything runs inside Docker and routes through a single exposed port (via
 Caddy), making it easy to develop locally or deploy remotely.</p>
 <hr />
-<h2 id="documentation">📚 Documentation</h2>
-<ul>
-<li><a href="gettingstarted/">Getting Started</a></li>
-<li><a href="migrations/">Migrations</a></li>
-<li><a href="extensions/">Postgres Extensions</a></li>
-<li><a href="authentication/">Authentication</a></li>
-<li><a href="psql/">Psql</a></li>
-<li><a href="deploying/">Deploying to Remote Environments</a></li>
-</ul>
+<h2 id="get-started">📚 Get Started</h2>
+<p>👉 <a href="gettingstarted/">Continue to Getting Started</a></p>
 
 
 

superstack/psql/index.html

@@ -406,15 +406,6 @@
     </span>
   </a>
 
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-inline-sql-commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      🔹 Run Inline SQL Commands
-    </span>
-  </a>
-  
 </li>
 
         <li class="md-nav__item">
@@ -709,15 +700,6 @@
     </span>
   </a>
 
-</li>
-      
-        <li class="md-nav__item">
-  <a href="#run-inline-sql-commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      🔹 Run Inline SQL Commands
-    </span>
-  </a>
-  
 </li>
 
         <li class="md-nav__item">
@@ -800,20 +782,17 @@
 
 
 <h1 id="using-psql">🖥️ Using psql</h1>
-<p><code>psql</code> is the command-line tool for interacting with your PostgreSQL
-database. SuperStack makes it easy to run psql inside the container using a
-helper script.</p>
+<p><code>psql</code> is the command-line tool for interacting with your PostgreSQL database.
+SuperStack makes it easy to run psql inside the container using a helper
+script.</p>
 <h2 id="open-a-psql-shell">📟 Open a psql Shell</h2>
 <p>To connect interactively:</p>
-<div class="highlight"><pre><span></span><code>bin/postgres<span class="w"> </span>psql
-</code></pre></div>
-<p>Example output:</p>
-<div class="highlight"><pre><span></span><code>psql (17.5 (Debian 17.5-1.pgdg120+1))
-Type &quot;help&quot; for help.
+<div class="highlight"><pre><span></span><code>$<span class="w"> </span>bin/postgres<span class="w"> </span>psql
+psql<span class="w"> </span><span class="o">(</span><span class="m">17</span>.5<span class="w"> </span><span class="o">(</span>Debian<span class="w"> </span><span class="m">17</span>.5-1.pgdg120+1<span class="o">))</span>
+Type<span class="w"> </span><span class="s2">&quot;help&quot;</span><span class="w"> </span><span class="k">for</span><span class="w"> </span>help.
 
-app=#
+<span class="nv">app</span><span class="o">=</span><span class="c1">#</span>
 </code></pre></div>
-<h2 id="run-inline-sql-commands">🔹 Run Inline SQL Commands</h2>
 <p>You can also run SQL directly from the command line:</p>
 <div class="highlight"><pre><span></span><code>bin/postgres psql -c &#39;select * from api.movie;&#39;
 </code></pre></div>