DyadPublishing your App
Step-by-step guide for deploying your app with GitHub and Vercel.
So, you've built something awesome and now you want to share it with other people (or the whole world).
You can deploy your Dyad app anywhere, including your favorite cloud provider. But if you're not sure where to start, I will show you a simple and free way of deploying using GitHub and Vercel.
Host your code on GitHub
GitHub is the most popular code hosting platform. You can use it for collaborating on open-source projects like Dyad, but you can also use it to host private projects.
Because GitHub is so popular, most Cloud providers have a solid GitHub integration, which means that whenever you push code to your GitHub project, your Cloud provider can re-deploy your application.
Create a GitHub account
Create a GitHub account if you don't have one already.
Create a GitHub project
Create a GitHub project. If you don't want other people to see your source code, then pick private. If you're not sure which is the right option, then pick private and you can always make it public later.
Connect your Dyad app to GitHub
From the Dyad home page, open the app details card by clicking on the app from the left sidenav (open it by clicking on the menu button in the top-left) and then click Connect to GitHub. Follow the steps in the app to authorize Dyad to connect to GitHub. Don't worry, only you will be able to push things to your GitHub projects.
Sync to GitHub
After you've connected your Dyad app to your GitHub project, you can click Sync to GitHub which will push the code from your local computer to GitHub.
You can press this anytime to push new changes to GitHub. For example, after you've made changes to your Dyad app locally, you can do Sync to GitHub again which will typically trigger a new build with Vercel, or whichever Cloud provider you're using.
Deploying with Vercel
Vercel is a popular Cloud provider, particularly for JavaScript apps like the ones that you build with Dyad. Vercel is an excellent option to start out with because the setup is very easy and it has a good free plan.
Sign in to Vercel with GitHub
Go to https://vercel.com/new and click Continue with GitHub using your GitHub account. This will make it easy to connect your GitHub project to Vercel.
Import and deploy your GitHub project
After you sign-in with GitHub on Vercel's site, you will see a section called Import Git Repository, which should show a list of your GitHub projects. Click on the Import button for the GitHub project for your app (or search for it, if you don't see it).
Vercel will automatically detect which framework (e.g. Vite) you're using so in most cases you can just click Deploy. If you have some kind of API integration (e.g. Supabase, OpenAI), you may need to put in your environmental variables. If you forget, it's OK, you can always add it in later.
Check your deployment
After Vercel builds and deploys your application, you should see a URL like dyad-app-name.vercel.app. Go to the URL and make sure the app is working as expected. You can now share your app with anyone on this URL!
Keep in mind, your app is now visible to the whole world, so avoid having any sensitive content without the proper auth and security protections.
If you want to push new changes, just click on the Sync to GitHub button for your Dyad app within Dyad and your new code will be pushed to GitHub and be picked up by Vercel.