Update setup instructions to use the template

Author: bcb

README.md

@@ -24,16 +24,18 @@ flowchart TD
 
 ## 🚀 Quick Start
 
-1. **Clone SuperStack and start the stack:**
+1. [Create your repository from the SuperStack template](https://github.com/explodinglabs/superstack/generate)
+
+2. Clone your repository and start SuperStack:
 
 ```sh
-git clone https://github.com/explodinglabs/superstack myapp
+git clone https://github.com/yourname/myapp myapp
 cd myapp
 cp example.env .env
 docker compose up -d
 ```
 
-2. **Explore your API**
+3. **Explore your API**
 
 Open [http://localhost:8000/openapi/](http://localhost:8000/openapi/) in your
 browser to view and test endpoints using Swagger UI.

docs/gettingstarted.md

@@ -3,51 +3,45 @@
 SuperStack uses Docker, so make sure [Docker is
 installed](https://docs.docker.com/get-docker/) before you begin.
 
-## 1. Clone SuperStack
+## Get SuperStack
 
-```sh
-git clone https://github.com/explodinglabs/superstack myapp
-cd myapp
-```
+### Option 1: Use the Template (Recommended)
+
+The easiest way to get started:
 
-<details>
-<summary>Click here to see how to change this clone to point "origin" to your own hosted repository (Recommended)</summary>
+Click [Use this template](https://github.com/explodinglabs/superstack/generate)
+and create a new repository (e.g. `myapp`) on GitHub.
 
-Rename "origin" to "upstream":
+Clone your new repository:
 
 ```sh
-git remote rename origin upstream
+git clone https://github.com/yourname/myapp.git
+cd myapp
 ```
 
-This way you can still upgrade to a more recent SuperStack with:
+### Option 2: Clone and Track Upstream (Advanced)
+
+If you want to keep SuperStack’s Git history and pull upstream changes later:
 
 ```sh
-git pull upstream main
+git clone https://github.com/explodinglabs/superstack.git myapp
+cd myapp
 ```
 
-Add your own code repository:
+Create your own repo at [https://github.com/new](https://github.com/new), then:
 
 ```sh
-git remote add origin https://github.com/yourname/myapp
+git remote rename origin upstream
+git remote add origin https://github.com/yourname/myapp.git
+git push -u origin main
 ```
 
-Now you can pull/push to your own repo as normal:
+You can now pull upstream changes with:
 
 ```sh
-git pull
-git push origin head
+git pull upstream main
 ```
 
-<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>
-
 ## 2. Configure Environment Variables
 
 Copy the example file:
@@ -67,8 +61,9 @@ docker compose up -d
 
 That's it – your backend is live.
 
-You can now open [localhost:8000/openapi/](http://localhost:8000/openapi/)
-to explore your API.
+You can now open
+[https://localhost:8000/openapi/](http://localhost:8000/openapi/) to explore
+your API.
 
 ---