Before you being, install Wasp by running curl -sSL https://get.wasp-lang.dev/installer.sh | sh
in your terminal.
ou have two options to run this template locally:
- Run
wasp new <project-name> -t saas
. This will clone and set up the repo in the background. - Create a
.env.server
file in the root of the project - Copy the
env.example
file contents to.env.server
and fill in your API keys - Make sure you have a Database connected and running. Here are two quick options:
- run
wasp start db
if you have Docker installed (if not, on MacOS runbrew install docker-machine docker
). This will start a Postgres database for you. No need to do anything else! 🤯 - or provision a Postgres database on Railway, go to settings and copy the
connection url
. Past it asDATABASE_URL=<your-postgres-connection-url>
into yourenv.server
file.
- Run
wasp db migrate-dev
- Run
wasp start
. This will install all dependencies and start the client and server for you :) - Go to
localhost:3000
in your browser (your NodeJS server will be running on port3001
) - Install the Wasp extension for VSCode to get the best DX
- Check the files for comments containing specific instructions
- Enjoy and Have fun. When you create an App with this template, be kind and let me know by tagging me on twitter @hot_town
- 🐝 Wasp - allows you to build full-stack apps with 10x less boilerplate
- 🎨 Tailwind CSS - CSS that's easy to work with
- 🤖 OpenAI - GPT-3.5 turbo API
- 💸 Stripe - for payments
- 📧 SendGrid - for email
Wasp as the full-stack framework allows you to describe your app’s core features in the main.wasp
config file in the root directory. Then it builds and glues these features into a React-Express-Prisma app for you so that you can focus on writing the client and server-side logic instead of configuring. For example, I did not have to use any third-party libraries for Google Authentication. I just wrote a couple lines of code in the config file stating that I want to use Google Auth, and Wasp configures it for me. Check out the comments main.wasp
file for more.
Stripe makes the payment functionality super easy. I just used their Subscription
feature. After the user pays, their hasPaid
and datePaid
fields are updated in the database via the webhook found in the src/server/serverSetup.ts
file.
Wasp's integrated Jobs feature is used to run a cron job every week to send an newsletter email. I used SendGrid for the email service.
If you have any other questions, feel free to reach out to me on twitter