mirror of
https://github.com/supabase/supabase.git
synced 2026-10-05 09:25:06 +03:00
docs(cli): group the CLI sections and head the intro procedure
The page was nine flat H2s, and the intro opened with a two-step procedure under no heading, before the CLI is installed. - Group local setup under Set up a local project, and updating and beta builds under Manage your CLI installation. Connect to a hosted project stays top level, since linking is a different goal from local setup. - Put the intro's `init` and `start` list under Quickstart. Every grouped section keeps its heading text, so the slugs are unchanged and the on-page contents nests instead of shrinking.
This commit is contained in:
1 parent
5c85b1079a
commit
1c8d0bf862
1 file changed
+19
-7
@@ -4,7 +4,11 @@ description: 'The Supabase CLI provides tools to develop your project locally, d
|
||||
subtitle: 'Develop locally, deploy to the Supabase Platform, and set up CI/CD workflows'
|
||||
---
|
||||
|
||||
The Supabase CLI lets you run the entire Supabase stack locally, on your machine or in a CI environment. With two commands, you can set up and start a new local project:
|
||||
The Supabase CLI lets you run the entire Supabase stack locally, on your machine or in a CI environment.
|
||||
|
||||
## Quickstart
|
||||
|
||||
With two commands, you can set up and start a new local project:
|
||||
|
||||
1. `supabase init` to create a new local project
|
||||
2. `supabase start` to launch the Supabase services
|
||||
@@ -22,7 +26,11 @@ The rest of this page writes examples as `supabase <command>`; translate them to
|
||||
|
||||
</Admonition>
|
||||
|
||||
## Installing the Supabase CLI
|
||||
## Set up a local project
|
||||
|
||||
Install the CLI, bring the Supabase stack up on your machine, and stop it when you're done.
|
||||
|
||||
### Installing the Supabase CLI
|
||||
|
||||
<Tabs
|
||||
scrollable
|
||||
@@ -96,7 +104,7 @@ and run one of the following:
|
||||
</TabPanel>
|
||||
</Tabs>
|
||||
|
||||
## Running a local Supabase project
|
||||
### Running a local Supabase project
|
||||
|
||||
The most common thing you'll do with the CLI is run the full Supabase stack (Postgres, Auth, Storage, and the rest) on your own machine. That stack runs in Docker containers, so you need a container runtime installed first. On Windows and Linux, follow the official guide to install and configure [Docker Desktop](https://docs.docker.com/desktop).
|
||||
|
||||
@@ -130,7 +138,7 @@ If you installed the CLI as a project dependency (npm, pnpm, yarn, or bun), run
|
||||
|
||||
This takes time on your first run because the CLI needs to download the Docker images to your local machine. The CLI includes the entire Supabase stack, and a few additional images useful for local development (like a local SMTP server and a database diff tool).
|
||||
|
||||
## Access your project's services
|
||||
### Access your project's services
|
||||
|
||||
After all the Supabase services are running, the CLI prints your local credentials. The output looks like this, with the URLs and keys you use in your local project:
|
||||
|
||||
@@ -242,7 +250,7 @@ All logs are stored in the local database under the `_analytics` schema.
|
||||
</TabPanel>
|
||||
</Tabs>
|
||||
|
||||
## Stopping local services
|
||||
### Stopping local services
|
||||
|
||||
When you finish working, stop the stack. This doesn't reset your local database:
|
||||
|
||||
@@ -250,7 +258,11 @@ When you finish working, stop the stack. This doesn't reset your local database:
|
||||
supabase stop
|
||||
```
|
||||
|
||||
## Beta channel
|
||||
## Manage your CLI installation
|
||||
|
||||
These sections cover the CLI itself rather than your local project.
|
||||
|
||||
### Beta channel
|
||||
|
||||
Pre-release CLI builds ship from the development branch (`X.Y.Z-beta.N` versions). Use the npm `beta` dist-tag, or install `supabase-beta` via Homebrew / Scoop (separate packages from stable).
|
||||
|
||||
@@ -308,7 +320,7 @@ Beta builds are attached to [GitHub pre-releases](https://github.com/supabase/cl
|
||||
</TabPanel>
|
||||
</Tabs>
|
||||
|
||||
## Updating the Supabase CLI
|
||||
### Updating the Supabase CLI
|
||||
|
||||
When a new [version](https://github.com/supabase/cli/releases) is released, you can update the CLI using the same package manager you installed it with.
|
||||
|
||||
|
||||
Reference in new issue
Block a user