Replace placeholder with The Plural Stack site

.env-sample

@@ -0,0 +1,3 @@
+SANITY_PROJECT_ID=""
+SANITY_TOKEN=""
+SANITY_DATASET="production"

.gitignore

@@ -0,0 +1,24 @@
+# build output
+dist/
+
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# Local Netlify folder
+.netlify

.nvmrc

@@ -0,0 +1 @@
+v20

.prettierrc

@@ -0,0 +1,14 @@
+{
+    "printWidth": 160,
+    "singleQuote": true,
+    "trailingComma": "none",
+    "tabWidth": 4,
+    "overrides": [
+        {
+            "files": ["*.md", "*.yaml"],
+            "options": {
+                "tabWidth": 2
+            }
+        }
+    ]
+}

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,19 @@
+{
+    "editor.tabSize": 4,
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+        "source.fixAll.eslint": "explicit"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode",
+        "editor.formatOnSave": true
+    },
+    "[yaml]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode",
+        "editor.tabSize": 2
+    },
+    "[markdown]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode",
+        "editor.tabSize": 2
+    }
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 netlify-templates
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,53 +1,95 @@
-# pluralstack.org
+# Astro Sanity Starter
 
-Website for **Plural Stack**, a project of [RadicalxChange](https://www.radicalxchange.org).
+[Live Demo](https://astro-sanity-starter-demo.netlify.app/)
 
-This is a plain static site: no build step, no framework. `index.html` is the site.
+A minimal Astro and Sanity CMS starter template for building modern, content-driven websites.
 
-## How it deploys
+| Prerequisites                                                                |
+| :--------------------------------------------------------------------------- |
+| [Node.js](https://nodejs.org/) v20.+                                         |
+| (optional) [nvm](https://github.com/nvm-sh/nvm) for Node version management. |
 
-Netlify (RxC's team account) watches this repository. Every push to `main`
-is live at [pluralstack.org](https://pluralstack.org) within about a minute.
-Pull requests get an automatic preview URL, so you can review changes
-before merging.
+## Getting Started
 
-## Editing content
+Create local project from this repo and run:
 
-- **In the browser:** open the file on GitHub, press `.` or use the pencil
-  icon, edit, and commit to a branch → open a PR → merge when the preview
-  looks right.
-- **Locally:** clone, edit, push. There is nothing to install or build.
+```txt
+npm install
+```
 
-## Portability rule
+### Sign Into Sanity
 
-This project may later move to EU-based hosting (e.g. Hetzner, Codeberg
-Pages) for data-sovereignty reasons. To keep that migration trivial:
+If you are not already signed into Sanity via the CLI, install the CLI package and then run the login command.
 
-1. Keep the site as plain static files — no host-specific build magic.
-2. Keep DNS at the registrar (Porkbun), **not** delegated to Netlify.
-3. Don't adopt Netlify-proprietary features beyond `netlify.toml`
-   headers and, if ever needed, a portable `_redirects` file.
+```txt
+npm install -g @sanity/cli
+sanity login
+```
 
-If you follow those three rules, moving hosts is a DNS change plus a CI
-tweak.
+This will open a browser and walk you through the authentication process.
 
-## Infrastructure notes
+### Import Content
 
-| Thing    | Where                | Notes                                   |
-|----------|----------------------|-----------------------------------------|
-| Domain   | Porkbun              | Auto-renew on; WHOIS privacy on         |
-| DNS      | Porkbun              | A record (apex) + CNAME (www) → Netlify |
-| Hosting  | Netlify (RxC team)   | Site imported from this repo            |
-| Email    | Porkbun forwarding   | hello@pluralstack.org → project lead    |
+Once authenticated, you'll be able to create a Sanity project and import content.
 
-## One-time setup (already done / for reference)
+```txt
+npm run create-project
+```
 
-1. Create this repo under the RxC GitHub org; add the `plural-stack`
-   team with Write access.
-2. Netlify → Add new site → Import from GitHub → this repo.
-   Build command: none. Publish directory: `.`
-3. Netlify → Domain management → Add `pluralstack.org` → choose
-   **external DNS** (do not delegate nameservers to Netlify).
-4. Porkbun → DNS for pluralstack.org: add the A record and `www` CNAME
-   Netlify displays; delete Porkbun's default parking records.
-5. SSL provisions automatically (Let's Encrypt) once DNS propagates.
+_Note: You may want to sign into Sanity in the browser and rename your project._
+
+Once the project exists and you've set the environment variables, you can import the content.
+
+```txt
+npm run import {projectId}
+```
+
+Replace `{projectId}` with the project ID output from the previous command.
+
+### Store Sanity Values
+
+Sign into Sanity to create an editor token, navigate to the following address (replace the `SANITY_PROJECT_ID` with your project ID) `https://www.sanity.io/manage/personal/project/SANITY_PROJECT_ID/api#tokens`. Then create `.env` file in you repo, copy & paste the following environment variables into the file and set their values.
+
+```txt
+SANITY_PROJECT_ID="..."
+SANITY_DATASET="..."
+SANITY_TOKEN="..."
+```
+
+### Run Sanity Studio
+
+Sanity Studio code exists for this project in the `studio` directory. First, install the dependencies in this directory.
+
+```txt
+cd studio
+npm install
+```
+
+Then create a `.env` file in the `studio` directory with the following environment variables and set their values:
+
+```txt
+SANITY_STUDIO_PROJECT_ID="..."
+SANITY_STUDIO_DATASET="..."
+```
+
+Then run the studio locally.
+
+```txt
+sanity dev
+```
+
+If you want to see the content, you can open your browser and navigate to localhost:3333.
+
+### Start Development Server
+
+Then you can run the Astro.js development server in root directory:
+
+```txt
+npm run dev
+```
+
+Open your browser and navigate to `http://localhost:3000` to see your site.
+
+## Support
+
+If you get stuck along the way, get help in our [support forums](https://answers.netlify.com/).