sync

Author: Rich-Harris

apps/svelte.dev/content/docs/cli/10-introduction/10-overview.md

@@ -2,23 +2,18 @@
 title: Overview
 ---
 
-`sv`, the Svelte CLI, aims to combine multiple tools into one single easy to remember command.
+The command line interface (CLI), `sv`, is a toolkit for creating and maintaining Svelte applications.
 
 ## Usage
 
-The best way to use our cli is to run one of the following commands, depending on your package manager
+The easiest way to run `sv` is with [`npx`](https://docs.npmjs.com/cli/v8/commands/npx) (or the equivalent command if you're using a different package manager — for example, `pnpx` if you're using [pnpm](https://pnpm.io/)):
 
 ```bash
 npx sv <command> <args>
-pnpx sv <command> <args>
-# todo: should we add other package managers or just leave npx? Same goes for all other snippets
 ```
 
-## Commands
+If you're inside a project where `sv` is already installed, this will use the local installation, otherwise it will download the latest version and run it without installing it, which is particularly useful for [`sv create`](sv-create).
 
-| Command            | Sample usage                     | Description                                    |
-| ------------------ | -------------------------------- | ---------------------------------------------- |
-| [`create`](create) | `npx sv create ./my-project`     | Scaffolds new projects                         |
-| [add](add)         | `npx sv add [adder...]`          | Customize your projects to add different tools |
-| migrate            | `npx sv migrate <migrationName>` | Migrate your project                           |
-| check              | `npx sv check`                   | Typecheck your Svelte files                    |
+## Acknowledgements
+
+Thank you to [Christopher Brown](https://github.com/chbrown) who originally owned the `sv` name on npm for graciously allowing it to be used for the Svelte CLI. You can find the original `sv` package at [`@chbrown/sv`](https://www.npmjs.com/package/@chbrown/sv).

apps/svelte.dev/content/docs/cli/20-commands/10-create.md

@@ -0,0 +1,55 @@
+---
+title: sv create
+---
+
+`sv create` sets up a new SvelteKit project, with options to [setup additional functionality](sv-add#Official-integrations).
+
+## Usage
+
+```bash
+npx sv create [options] [path]
+```
+
+## Options
+
+<!-- TODO this flag should probably just be '--types', and the options should be 'ts' or 'jsdoc' -->
+
+### `--check-types <option>`
+
+Whether and how to add typechecking to the project:
+
+- `typescript` — default to `.ts` files and use `lang="ts"` for `.svelte` components
+- `checkjs` — use [JSDoc syntax](https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html) for types
+- `none` — no typechecking. Not recommended!
+
+### `--template <name>`
+
+Which project template to use:
+
+- `minimal` — barebones scaffolding for your new app
+- `demo` — showcase app with a word guessing game that works without JavaScript
+- `library` — template for a Svelte library, set up with `svelte-package`
+
+### `--no-integrations`
+
+<!-- TODO should be renamed to `--no-addons` -->
+
+Run the command without the interactive add-ons prompt
+
+### `--no-install`
+
+Skip dependency installation
+
+<!-- ## Programmatic interface
+
+```js
+// TODO: this gives type checking errors in the docs site when not commented out. Need to release sv, install it in the site, and uncomment this.
+// import { create } from 'sv';
+
+// // todo: check if this is right
+// create(cwd, {
+// 	// add your options here
+// 	// todo: list available option
+// });
+```
+-->

apps/svelte.dev/content/docs/cli/20-commands/10-sv-create.md

@@ -0,0 +1,39 @@
+---
+title: sv add
+---
+
+`sv add` updates an existing project with new functionality.
+
+## Usage
+
+```bash
+npx sv add
+```
+
+```bash
+npx sv add [add-ons]
+```
+
+You can select multiple space-separated add-ons from [the list below](#Official-add-ons), or you can use the interactive prompt.
+
+## Options
+
+- `-C`, `--cwd` — path to the root of your Svelte(Kit) project
+- `--no-preconditions` — skip checking preconditions <!-- TODO what does this mean? -->
+- `--no-install` — skip dependency installation
+
+## Official add-ons
+
+<!-- TODO this should be a separate section, each of these should have their own page -->
+
+- `drizzle`
+- `eslint`
+- `lucia`
+- `mdsvex`
+- `paraglide`
+- `playwright`
+- `prettier`
+- `routify`
+- `storybook`
+- `tailwindcss`
+- `vitest`