App Deployment

Deploying publishes your app on Sim’s managed infrastructure so it can continuously index data and serve production-ready APIs. This guide shows how to connect a local project to GitHub, import it into the Sim dashboard and trigger the first build.

​

Create GitHub repo

Open GitHub and create a new repository named after the folder that contains your project. In the Quickstart we used my-first-idx-app.

​

Push app to GitHub

When you ran sim init, besides initializing your app, the CLI created a Git repository and committed the first version of your code. Point the repo at GitHub and push the commit.

Copy the code snippet from GitHub for pushing a code snippet from the command line. It should look like the following:

# inside your project folder
git remote add origin https://github.com/your-username/my-first-idx-app.git
git branch -M main
git push -u origin main

​

Import repo

Open the Sim dashboard at sim.dune.com, select IDX in the sidebar and click Import Repo. The first time you do this you will have to install the Dune Sim GitHub App.

​

Install GitHub App

Choose the GitHub account, select allow all or only the repositories you need and click Install. After installation you return to the import screen and pick your repo.

​

Configure & deploy

Review the settings for the App name, the optional description, then press Deploy. The dashboard will show the deployment with status Building.

​

Monitor deployment progress

Return to the Sim dashboard, click on your app in the IDX tab and watch the new deployment move from Building → Ingesting → Ready. Once the status shows Ingesting, your APIs and database are live and serving data.

​

Next steps

Your first build is now running. Head over to the App Page to learn where to find the database connection string, generated API endpoints and deployment status. Once you have your first deployment live, you can start iterating on your Listener Contract to capture additional onchain events and shape your database schema.