mirror of
https://github.com/wasp-lang/wasp.git
synced 2024-12-29 20:12:28 +03:00
60233dcbcc
Co-authored-by: Mihovil Ilakovac <mihovil@ilakovac.com> Co-authored-by: Martin Šošić <Martinsos@users.noreply.github.com> Co-authored-by: Filip Sodić <filip.sodic@gmail.com> Co-authored-by: Filip Sodić <filip.sodic@fer.hr>
162 lines
6.4 KiB
Markdown
162 lines
6.4 KiB
Markdown
---
|
|
title: CLI Reference
|
|
---
|
|
This guide provides an overview of the Wasp CLI commands, arguments, and options.
|
|
|
|
## Overview
|
|
|
|
Once [installed](/docs/quick-start), you can use the wasp command from your command line.
|
|
|
|
If you run the `wasp` command without any arguments, it will show you a list of available commands and their descriptions:
|
|
|
|
```
|
|
USAGE
|
|
wasp <command> [command-args]
|
|
|
|
COMMANDS
|
|
GENERAL
|
|
new [<name>] [args] Creates a new Wasp project. Run it without arguments for interactive mode.
|
|
OPTIONS:
|
|
-t|--template <template-name>
|
|
Check out the templates list here: https://github.com/wasp-lang/starters
|
|
|
|
version Prints current version of CLI.
|
|
waspls Run Wasp Language Server. Add --help to get more info.
|
|
completion Prints help on bash completion.
|
|
uninstall Removes Wasp from your system.
|
|
IN PROJECT
|
|
start Runs Wasp app in development mode, watching for file changes.
|
|
start db Starts managed development database for you.
|
|
db <db-cmd> [args] Executes a database command. Run 'wasp db' for more info.
|
|
clean Deletes all generated code and other cached artifacts.
|
|
Wasp equivalent of 'have you tried closing and opening it again?'.
|
|
build Generates full web app code, ready for deployment. Use when deploying or ejecting.
|
|
deploy Deploys your Wasp app to cloud hosting providers.
|
|
telemetry Prints telemetry status.
|
|
deps Prints the dependencies that Wasp uses in your project.
|
|
dockerfile Prints the contents of the Wasp generated Dockerfile.
|
|
info Prints basic information about current Wasp project.
|
|
test Executes tests in your project.
|
|
|
|
EXAMPLES
|
|
wasp new MyApp
|
|
wasp start
|
|
wasp db migrate-dev
|
|
|
|
Docs: https://wasp-lang.dev/docs
|
|
Discord (chat): https://discord.gg/rzdnErX
|
|
Newsletter: https://wasp-lang.dev/#signup
|
|
```
|
|
|
|
## Commands
|
|
|
|
### Creating a New Project
|
|
- Use `wasp new` to start the interactive mode for setting up a new Wasp project.
|
|
|
|
This will prompt you to input the project name and to select a template. The chosen template will then be used to generate the project directory with the specified name.
|
|
|
|
```
|
|
$ wasp new
|
|
Enter the project name (e.g. my-project) ▸ MyFirstProject
|
|
Choose a starter template
|
|
[1] basic (default)
|
|
[2] saas
|
|
[3] todo-ts
|
|
▸ 1
|
|
|
|
🐝 --- Creating your project from the basic template... ---------------------------
|
|
|
|
Created new Wasp app in ./MyFirstProject directory!
|
|
To run it, do:
|
|
|
|
cd MyFirstProject
|
|
wasp start
|
|
```
|
|
- To skip the interactive mode and create a new Wasp project with the default template, use `wasp new <project-name>`.
|
|
|
|
```
|
|
$ wasp new MyFirstProject
|
|
🐝 --- Creating your project from the basic template... ---------------------------
|
|
|
|
Created new Wasp app in ./MyFirstProject directory!
|
|
To run it, do:
|
|
|
|
cd MyFirstProject
|
|
wasp start
|
|
```
|
|
### Project Commands
|
|
- `wasp start` launches the Wasp app in development mode. It automatically opens a browser tab with your application running and watches for any changes to .wasp or files in `src/` to automatically reflect in the browser. It also shows messages from the web app, the server and the database on stdout/stderr.
|
|
- `wasp start db` starts the database for you. This can be very handy since you don't need to spin up your own database or provide its connection URL to the Wasp app.
|
|
- `wasp clean` removes all generated code and other cached artifacts. If using SQlite, it also deletes the SQlite database. Think of this as the Wasp version of the classic "turn it off and on again" solution.
|
|
|
|
```
|
|
$ wasp clean
|
|
|
|
Deleting .wasp/ directory...
|
|
Deleted .wasp/ directory.
|
|
```
|
|
|
|
- `wasp build` generates the complete web app code, which is ready for [deployment](/docs/advanced/deployment/overview). Use this command when you're deploying or ejecting. The generated code is stored in the `.wasp/build` folder.
|
|
|
|
- `wasp deploy` makes it easy to get your app hosted on the web.
|
|
|
|
Currently, Wasp offers support for [Fly.io](https://fly.io). If you prefer a different hosting provider, feel free to let us know on Discord or submit a PR by updating [this TypeScript app](https://github.com/wasp-lang/wasp/tree/main/waspc/packages/deploy).
|
|
|
|
Read more about automatic deployment [here](/docs/advanced/deployment/cli).
|
|
|
|
- `wasp telemetry` displays the status of [telemetry](https://wasp-lang.dev/docs/telemetry).
|
|
|
|
```
|
|
$ wasp telemetry
|
|
|
|
Telemetry is currently: ENABLED
|
|
Telemetry cache directory: /home/user/.cache/wasp/telemetry/
|
|
Last time telemetry data was sent for this project: 2021-05-27 09:21:16.79537226 UTC
|
|
Our telemetry is anonymized and very limited in its scope: check https://wasp-lang.dev/docs/telemetry for more details.
|
|
|
|
```
|
|
- `wasp deps` lists the dependencies that Wasp uses in your project.
|
|
- `wasp info` provides basic details about the current Wasp project.
|
|
|
|
### Database Commands
|
|
Wasp provides a suite of commands for managing the database. These commands all begin with `db` and primarily execute Prisma commands behind the scenes.
|
|
|
|
- `wasp db migrate-dev` synchronizes the development database with the current state of the schema (entities). If there are any changes in the schema, it generates a new migration and applies any pending migrations to the database.
|
|
- The `--name foo` option allows you to specify a name for the migration, while the `--create-only` option lets you create an empty migration without applying it.
|
|
|
|
- `wasp db studio` opens the GUI for inspecting your database.
|
|
|
|
|
|
### Bash Completion
|
|
|
|
To set up Bash completion, run the `wasp completion` command and follow the instructions.
|
|
|
|
|
|
### Miscellaneous Commands
|
|
- `wasp version` displays the current version of the CLI.
|
|
|
|
```
|
|
$ wasp version
|
|
|
|
0.11.1
|
|
```
|
|
- `wasp uninstall` removes Wasp from your system.
|
|
|
|
```
|
|
$ wasp uninstall
|
|
|
|
🐝 --- Uninstalling Wasp ... ------------------------------------------------------
|
|
|
|
We will remove the following directories:
|
|
{home}/.local/share/wasp-lang/
|
|
{home}/.cache/wasp/
|
|
|
|
We will also remove the following files:
|
|
{home}/.local/bin/wasp
|
|
|
|
Are you sure you want to continue? [y/N]
|
|
y
|
|
|
|
✅ --- Uninstalled Wasp -----------------------------------------------------------
|
|
```
|