Frontend — Deploying with Vercel

On this page, we are looking at how to deploy Gieß den Kiez on Vercel. For this, you will need a GitHub account and a Vercel account.

1. Log into GitHub and fork the Gieß den Kiez repo.
2. Log into Vercel and click on "Add new project"
3. Select GitHub as your Git provider and select your Gieß den Kiez fork.
4. Click on "Environment Variables" and fill in the required environment variables

   • see the .env.example in the Repository for details or
   • see the documentation at Setup Vercel for details

5. Click on Deploy

You successfully deployed your own Gieß den Kiez!

Next, find out how to add custom domains on Vercel.

We also need to tell Mapbox to allow our new URL to load our Mapbox basemap and tilesets.

1. Log into your Mapbox Account and click on your Gieß den Kiez project.
2. Copy the fresh URL of your Vercel site, and add it to the allowlist of URLs. Otherwise, Mapbox won't load the tiles.
3. Save. You should now see the map loading when reloading the page. Note that it might take a while before the new permissions apply.

Perfect. Everything should now work just fine.