# How to Deploy MDX Deck with Vercel

**Author:** Matthew Sweeney

---

This guide will show you how to deploy an MDX Deck app and get your domain set up.

[MDX Deck](https://github.com/jxnblk/mdx-deck) is an award-winning React and MDX-based presentation framework.

## Deploy MDX Deck to Vercel

Vercel is a platform for deploying the fastest MDX Deck apps. You can deploy your app with zero configuration to the best [frontend infrastructure](https://vercel.com/features/infrastructure).

- **Develop:** Build MDX Deck apps that connect to your favorite APIs, databases, and content management systems.
  
- **Preview:** Integrate with any GitHub, GitLab, or Bitbucket repository for [instant continuous deployment](https://vercel.com/features/previews).
  
- **Ship:** Deploy your app to every edge node worldwide for the fastest MDX Deck apps. Static files, Vercel Functions, the CDN, and [more](https://vercel.com/features/infrastructure).
  

## Built-in CI/CD for MDX Deck apps

Vercel has integrations for [GitHub](https://vercel.com/docs/deployments/git/vercel-for-github), [GitLab](https://vercel.com/docs/deployments/git/vercel-for-gitlab), and [Bitbucket](https://vercel.com/docs/deployments/git/vercel-for-bitbucket) to enable CI/CD for your MDX Deck app with zero configuration. Then, you can run [automated tests for performance and reliability](https://vercel.com/docs/concepts/deployments/checks) on every push. Pull and merge requests are deployed instantly to a unique URL, accessible to your entire team.

## Add your custom domain

After deploying, your new MDX Deck application will get automatically assigned a `.vercel.app` suffixed domain. You can then add a [Custom Domain](https://vercel.com/docs/concepts/projects/custom-domains) on your choice, either from a third-party or [purchased through Vercel](https://vercel.com/domains).

## Deploy MDX Deck to Vercel

### Vercel CLI

1. Install the [Vercel CLI](https://vercel.com/cli) and run `vercel` to deploy.
   
2. Vercel will detect that you are using MDX Deck and will enable the correct settings for your deployment.
   
3. Your application is deployed! (e.g. [mdx-deck.now-examples.vercel.app](https://mdx-deck.now-examples.vercel.app/))
   

### Vercel for Git

1. Push your code to your git repository (GitHub, GitLab, BitBucket).
   
2. [Import your MDX Deck project](https://vercel.com/new) into Vercel.
   
3. Vercel will detect that you are using MDX Deck and will enable the correct settings for your deployment.
   
4. Your application is deployed! (e.g. [mdx-deck.now-examples.vercel.app](https://mdx-deck.now-examples.vercel.app/))

---

[View full KB sitemap](/kb/sitemap.md)