Skip to main content

Getting Started

1. Requirements

You need to have node (and npm) installed on your machine and available in PATH.

  • node: ^18.12.0
  • npm: ^8.19.2

You can check node and npm versions by running:

node -v
npm -v

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 (aptitude, pacman, homebrew, ...) or alternatively via nvm install script.

Then, install a version of node that you need, e.g.:

nvm install 18

Finally, whenever you need to ensure specific version of node is used, run e.g.

nvm use 18

to set the node version for current shell session.

You can run

node -v

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

Check NVM repo for more details: https://github.com/nvm-sh/nvm .

Why this version of node?
At Wasp, we focus on supporting the latest LTS ("long-term-support") Node.js version, since it guarantees stability and active maintainance, which is why the official Node.js team recommends it for usage in production. Therefore, a specific Wasp release will usually require the version of Node.js that was LTS at that point of time. Check out https://nodejs.org/en/about/releases/ for more details about Node.js releases.

2. Installation

Open your terminal and run:

curl -sSL https://get.wasp-lang.dev/installer.sh | sh

3. Creating and running your first app

wasp new MyNewApp # Creates a new web app named MyNewApp.
cd MyNewApp
wasp start # Serves the web app.

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.

For Visual Studio Code

If you are using VSCode, install our Wasp language extension.

The extension brings the following functionality:

  • Syntax highlighting for .wasp files
  • Snippets for .wasp files
  • Wasp language server
  • live reporting of compilation errors
  • autocompletion

4. What next?

Check out the 🤓 Todo App tutorial 🤓 , which will take you through all the core features of Wasp!

Also, we would be excited to have you join our community on Discord! Any feedback or questions you have, we are there for you.

Finally, to stay up to date with updates in Wasp, you can subscribe to our newsletter: https://wasp-lang.dev/#signup . We usually send 1 per month, and Matija does his best to unleash his creativity to make them engaging and fun to read :D!