Skip to main content

Quick Start


Try Wasp Without Installing 🤔?

Give Wasp a spin in the browser without any setup by running our Wasp Template for Gitpod

Welcome, new Waspeteer 🐝!

To install Wasp on Linux / OSX / WSL(Win), open your terminal and run:

curl -sSL | sh

ℹī¸ Wasp requires Node.js and will warn you if it is missing: check below for more details.

Then, create a new app by running:

wasp new

and then run the app:

cd <my-project-name>
wasp start

That's it 🎉 You have successfully created and served a new web app at http://localhost:3000 and Wasp is serving both frontend and backend for you.

Something Unclear?

Check More Details section below if anything went wrong, or if you have additional questions.

What next?​

  • 👉 Check out the Todo App tutorial, which will take you through all the core features of Wasp! 👈
  • Setup your editor for working with Wasp.
  • Join us on Discord! Any feedback or questions you have, we are there for you.
  • Follow Wasp development by subscribing to our newsletter: . We usually send 1 per month, and Matija does his best to unleash his creativity to make them engaging and fun to read :D!

More details​


You must have Node.js (and NPM) installed on your machine and available in PATH. We rely on the latest Node.js LTS version (currently v18.14.2).

We recommend using nvm for managing your Node.js installation version(s).

Quick guide on installing/using nvm

Install nvm via your OS package manager (apt, pacman, homebrew, ...) or via the nvm install script.

Then, install a version of Node.js that you need:

nvm install 18

Finally, whenever you need to ensure a specific version of Node.js is used, run:

nvm use 18

to set the Node.js version for the current shell session.

You can run

node -v

to check the version of Node.js currently being used in this shell session.

Check NVM repo for more details:


Open your terminal and run:

curl -sSL | sh