wasp-lang/wasp

The fastest way to develop full-stack web apps with React & Node.js.

Website | Docs

Discord | Twitter | Youtube

Deployed? Get swag! 👕

Wasp (Web Application Specification) is a Rails-like framework for React, Node.js, and Prisma. Build your app in a day and deploy it with a single CLI command!

• 🚀 Quick start: Due to its expressiveness, you can create and deploy a production-ready web app from scratch with very few lines of concise, consistent, declarative code.
• 😌 No boilerplate: By abstracting away complex full-stack features, there is less boilerplate code. That means less code to maintain and understand! It also means easier upgrades.
• 🔓 No lock-in: You can deploy the Wasp app anywhere you like. There is no lock-in into specific providers; you have complete control over the code (and can actually check it out in .wasp/ directory if you are interested ).
• 🤖 Perfect for AI by design: Thanks to its high-level spec of the whole app, opinionated approach, built-in full-stack features, and tight integration of all parts of the stack, Wasp gives AI (agents) clear guardrails and structure, less boilerplate to manage, and better context management.

• 🔒 Full-stack Auth
• 🖇️ RPC (Client <-> Server)
• 🚀 Simple Deployment
• ⚙ ️Jobs
• ✉️ Email Sending
• 🛟 Full-stack Type Safety
• ...

Simple Wasp spec file in which you describe the high-level details of your web app:

// file: main.wasp.ts

import { app, page, query, route } from "@wasp.sh/spec";

import { MainPage } from "./src/MainPage" with { type: "ref" }; // Your React code.
import { DashboardPage } from "./src/dashboard/DashboardPage" with { type: "ref" };
import { getTasks } from "./src/queries" with { type: "ref" }; // Your Node.js code.

export default app({
  name: "todoApp",
  wasp: { version: "^0.24.0" },
  title: "ToDo App",
  head: ["<link rel='icon' href='/favicon.ico' />"],
  auth: {
    // Full-stack auth out-of-the-box.
    userEntity: "User",
    methods: {
      email: {
        // ...
      },
      google: {
        // ...
      },
    },
    onAuthFailedRedirectTo: "/login",
  },
  spec: [
    route("RootRoute", "/", page(MainPage)),
    route(
      "DashboardRoute",
      "/dashboard",
      page(DashboardPage, {
        authRequired: true, // Limit access to logged-in users.
      }),
    ),
    query(getTasks, {
      entities: ["Task"], // Automatic cache invalidation.
    }),
  ],
});

And a Prisma schema for the database:

// file: schema.prisma

model Task { // Your Prisma data model.
  id          Int     @id @default(autoincrement())
  description String
  isDone      Boolean @default(false)
}

The rest of the code you write in React / Node.js and reference it from the *.wasp.ts files.

👉 Check out TodoApp example for a complete code example. 👈

Given a simple main.wasp.ts specification file that describes the high-level details of your web app, and .ts(x)/.css/..., source files with your unique logic, Wasp compiler generates the whole source of your web app in the target stack: front-end, back-end and deployment.

This unique approach is what makes Wasp "smart" and gives it its superpowers!

For more information about Wasp, check docs.

Run to install Wasp on OSX/Linux/WSL(Win):

npm i -g @wasp.sh/wasp-cli@latest

From there, follow the instructions to run your first app in less than a minute!

For a quick start, check out this docs page.

If you have a Wasp application running in production, we'd love to send some swag your way! Fill out this form, and we'll make it happen.

Wasp has official AI agent plugins to help you kickstart your next Wasp project. You can use them with your favorite AI-assisted coding tool (Cursor, Claude Code, etc.) to get a better result and development experience. Check out the Wasp Agent Plugins page for more details.

Currently, Wasp is in beta, with most features fully developed and functioning well. However, we still have many improvements and additions in mind for the future, and we are continually working on them. As a result, you can expect numerous changes and improvements in the future.

Keep up with Wasp by following our development roadmap.

While the idea is to support multiple web tech stacks in the future, we are currently focusing on a specific stack: React + TanStack Query, Node.js + Express.js, and Prisma.

We welcome contributions! Small, obvious fixes (typos, broken links, docs corrections, small bugs where the fix is clear and comes with a test) are welcome directly as PRs.

For anything bigger (new features, refactors, changes in behavior), please talk to us first, in a GitHub issue or on Discord, so we can agree on the approach before you write code.

Check out CONTRIBUTING for more details.

Even if you don't plan to submit any code, just joining the discussion on Discord and giving your feedback is already great and helps a lot (motivates us and helps us figure out how to shape Wasp)!

You can also:

• ⭐️ Star this repo to show your interest/support.
• 📫 Stay updated by subscribing to our email list.
• 👀 Check out the development roadmap.

Check our careers page for a list of currently opened positions!

- Our first sponsor ever! Thanks so much, Michel ❤️ , from the whole Wasp Team, for bravely going where nobody has been before :)!

- Thanks Shayne, for all the contributions you did so far and for your continuous support!

- Thanks VelocityOne for the generous donation!

- We are thankful for your support Ricardo in this early stage of Wasp :)!

- Thanks Thomas for supporting Wasp :)!

- Our awesome sponsor again and again!

- Big thanks for supporting us both via sponsorship and great suggestions!