chore: replatform docs site to Astro + Starlight (#7012)

* chore: replatform docs site to Astro + Starlight I tried to resist the temptation to fix other tech debt here (untyped JS, etc.). * feat: add better OG image * fix: replace dark logo with well-sized image * feat: add more social links * feat: link to forums cli tag * feat: change Changelog link to Release notes
netlify · Jan 23, 2025 · 2476843 · 2476843 · github-actions · Jan 23, 2025
1 parent c8bfd74
commit 2476843
Show file tree

Hide file tree

Showing 57 changed files with 10,010 additions and 24,731 deletions.
diff --git a/.github/workflows/docsearch.yml b/.github/workflows/docsearch.yml
diff --git a/.gitignore b/.gitignore
@@ -22,9 +22,8 @@ vendor
 /.netlify
 
 # site
-test-site
 site/dist
-site-cra
+site/.astro/
 site/src/**/*.md
 
 # tests

diff --git a/docs/commands/api.md b/docs/commands/api.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI api command
+sidebar:
+  label: api
 ---
 
 # `api`

diff --git a/docs/commands/blobs.md b/docs/commands/blobs.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI blobs command
+sidebar:
+  label: blobs
 description: Manage objects in Netlify Blobs
 ---
 

diff --git a/docs/commands/build.md b/docs/commands/build.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI build command
+sidebar:
+  label: build
 ---
 
 # `build`

diff --git a/docs/commands/completion.md b/docs/commands/completion.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI completion command
+sidebar:
+  label: completion
 description: Shell completion script for netlify CLI
 ---
 

diff --git a/docs/commands/deploy.md b/docs/commands/deploy.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI deploy command
+sidebar:
+  label: deploy
 ---
 
 # `deploy`

diff --git a/docs/commands/dev.md b/docs/commands/dev.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI dev command
+sidebar:
+  label: dev
 description: Run netlify dev locally
 ---
 

diff --git a/docs/commands/env.md b/docs/commands/env.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI env command
+sidebar:
+  label: env
 description: Control environment variables for the current site
 ---
 

diff --git a/docs/commands/functions.md b/docs/commands/functions.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI functions command
+sidebar:
+  label: functions
 description: Run netlify dev locally
 ---
 

diff --git a/docs/commands/init.md b/docs/commands/init.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI init command
+sidebar:
+  label: init
 description: Initialize a new site locally
 ---
 

diff --git a/docs/commands/integration.md b/docs/commands/integration.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI integration command
+sidebar:
+  label: integration
 description: Create, develop, and deploy integrations.
 ---
 

diff --git a/docs/commands/link.md b/docs/commands/link.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI link command
+sidebar:
+  label: link
 description: Link an existing site to a local site directory
 ---
 

diff --git a/docs/commands/login.md b/docs/commands/login.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI login command
+sidebar:
+  label: login
 description: Login to your Netlify account
 ---
 

diff --git a/docs/commands/logout.md b/docs/commands/logout.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI logout command
+sidebar:
+  label: logout
 description: Login to your Netlify account
 hidden: true
 ---

diff --git a/docs/commands/logs.md b/docs/commands/logs.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI logs command
+sidebar:
+  label: logs
 ---
 
 # `logs`

diff --git a/docs/commands/open.md b/docs/commands/open.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI open command
+sidebar:
+  label: open
 ---
 
 # `open`

diff --git a/docs/commands/recipes.md b/docs/commands/recipes.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI recipes command
+sidebar:
+  label: recipes
 ---
 
 # `recipes`

diff --git a/docs/commands/serve.md b/docs/commands/serve.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI serve command
+sidebar:
+  label: serve
 description: (Beta) Build the site for production and serve locally. This does not watch the code for changes, so if you need to rebuild your site then you must exit and run `serve` again.
 ---
 

diff --git a/docs/commands/sites.md b/docs/commands/sites.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI sites command
+sidebar:
+  label: sites
 description: Manage Netlify sites via the command line
 ---
 

diff --git a/docs/commands/status.md b/docs/commands/status.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI status command
+sidebar:
+  label: status
 description: Get the current context of the netlify CLI
 ---
 

diff --git a/docs/commands/switch.md b/docs/commands/switch.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI switch command
+sidebar:
+  label: switch
 description: Switch your active Netlify account
 ---
 

diff --git a/docs/commands/unlink.md b/docs/commands/unlink.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI unlink command
+sidebar:
+  label: unlink
 description: Link an existing site to a local site directory
 ---
 

diff --git a/docs/commands/watch.md b/docs/commands/watch.md
@@ -1,5 +1,7 @@
 ---
 title: Netlify CLI watch command
+sidebar:
+  label: watch
 description: Watch for site deploy to finish
 ---
 

diff --git a/docs/index.md b/docs/index.md
@@ -3,8 +3,6 @@ title: Netlify CLI command reference
 description: All Netlify CLI commands
 ---
 
-# Netlify CLI command reference
-
 To get a list of commands, run
 
 ```

diff --git a/netlify.toml b/netlify.toml
@@ -4,11 +4,6 @@
   # This is the directory is publishing to netlify's CDN
   publish = "site/dist"
 
-  [build.environment]
-    # cannot use node 18, as we use x0 which uses webpack 4
-    NODE_VERSION = "16"
-    AWS_LAMBDA_JS_RUNTIME = "nodejs16.x"
-
 [functions]
   # Sets a custom directory for Netlify Functions
   directory = "functions"
-Original file line number
+Diff line change
@@ Expand Up / @@ -3,8 +3,6 @@ title: Netlify CLI command reference @@
     description: All Netlify CLI commands
     ---
-    # Netlify CLI command reference
     To get a list of commands, run
     ```
@@ Expand Down @@