create-svelte
Without The PromptsWarning This package is not supported nor endorsed by the maintainers of Svelte. If you experience any issues with it you should file them in this repository and not in the official SvelteKit repository.
The Svelte team has been very explicit about not adding CLI arguments to
create-svelte
for good reasons. See https://github.com/sveltejs/kit/pull/6117#issuecomment-1221323822
create-svelte-with-args
is a simple wrapper around the create-svelte
package that allows you to specify the options as CLI arguments instead of using the interactive prompts.
This is useful if you want to automate the creation of SvelteKit projects, which can be pretty hard with interactive prompts.
Note If you do not need to create SvelteKit projects programmatically you probabvly just want to use the official
create-svelte
package instead of this one.
Run the CLi with
npm create svelte-with-args [args]
The arguments match one to one with the upstream programmatic create-svelte
package. All arguments except `--directory´ are required.
Argument | Description | Type | Example |
---|---|---|---|
--name , -n |
The name of the project | string |
--name=my-new-app |
--directory , -d |
Optional. The directory to install the project in. Defaults to the project name | string |
--directory=other-dir |
--template , -t |
The template to use | One of "default" , "skeleton" , "skeletonlib" |
--template=default |
--types , -y |
How types will be written | One of "checkjs" , "typescript" , "null" |
--types=checkjs |
--prettier , -p |
Whether prettier should be included | boolean |
--prettier or --no-prettier |
--eslint , -e |
Whether eslint should be included | boolean |
--eslint or --no-eslint |
--playwright , -l |
Whether playwright should be included | boolean |
--playwright or --no-playwright |
--vitest , -v |
Whether vitest should be included | boolean |
--vitest or --no-vitest |
--svelte5 , -5 |
If Svelte 5 beta should be used | boolean |
--svelte5 or --no-svelte5 |
Create a default project called my-new-app
that checks JS types with prettier but without eslint and playwright:
npm create svelte-with-args --name=my-new-app --template=default --types=checkjs --prettier --no-eslint --no-playwright --no-vitest --no-svelte5
Create a skeleton project without any type checking:
npm create svelte-with-args --name=my-new-app --template=skeleton --types=null --no-prettier --no-eslint --no-playwright --no-vitest --no-svelte5
--help
create-svelte-with-args [args]
Options:
--help Show help [boolean]
--version Show version number [boolean]
-n, --name The name of the project [string] [required]
-d, --directory The directory to install the project in. Defaults to the
project name [string]
-t, --template The template to use
[string] [required] [choices: "default", "skeleton", "skeletonlib"]
-y, --types How types will be written
[required] [choices: "checkjs", "typescript", null]
-p, --prettier Whether prettier should be included [boolean] [required]
-e, --eslint Whether eslint should be included [boolean] [required]
-l, --playwright Whether playwright should be included [boolean] [required]
-v, --vitest Whether vitest should be included [boolean] [required]
-5, --svelte5 If Svelte 5 beta should be used [boolean] [required]
--dry Whether to run in dry run mode, not creating any files
[boolean] [default: false]
Examples:
npm create svelte-with-args@latest Default app, checking JS types, with
--name=my-new-app --template=default Prettier, and no ESLint, Playwright
--types=checkjs --prettier --no-eslint or Vitest
--no-playwright --no-vitest --no-svelte5
npm create svelte-with-args@latest Default app, installing in specified
--name=my-new-app directory
--directory=other-dir/my-app
--template=default --types=typescript
--no-prettier --no-eslint
--no-playwright --no-vitest --no-svelte5
For more information, see https://github.com/storybookjs/create-svelte-with-args
Releases are handled automatically by auto. By setting the correct labels on a pull request, the semantic versioning is handled automatically, GitHub releases are generated as well as a changelog.
Once a pull request has been merged to main
it is automatically released as the latest
version.