wasp-lang / wasp

The fastest way to develop full-stack web apps with React & Node.js.
https://wasp-lang.dev
MIT License
13.68k stars 1.18k forks source link

Write "Going into production" docs / rewrite of deployment docs #2358

Open infomiho opened 2 days ago

infomiho commented 2 days ago

Users deploying Wasp apps sometimes get stuck and they report it on our Discord. Some of the common themes:

We cover a lot of topics in our docs (manual deployment, deploying using the Wasp CLI, env variables, some general Prisma advice) but we don't have the "going into production" topic covered from start to finish.

Here's a rough outline on what I plan to write: Image Image

One of the moves is recommended by our Discord member: moving the deployment docs on the top level. I agree with that, since all users will want to deploy, it shouldn't be hidden away in the Advanced section.

Ideally, we'd make a new top level category Deployment with the following rough outline:

Deployment/
├─ Wasp building blocks
├─ Env variables
├─ Database and schema migrations
├─ Deployment methods/
│  ├─ PaaS options
│  ├─ Self-hosting 
│  ├─ Static hosting for the client
├─ CI/CD setup
├─ Extras/
│  ├─ Using a custom domain
│  ├─ What can Wasp handle in production
│  ├─ DDoS and CDN
Martinsos commented 2 days ago

This will be great! These two issues are very relevant: https://github.com/wasp-lang/wasp/issues/2201 and https://github.com/wasp-lang/wasp/issues/2053 . These two might be relevant: https://github.com/wasp-lang/wasp/issues/1927 and https://github.com/wasp-lang/wasp/issues/1464 .