Vercel offers an extremely helpful marketplace that allows you to extend and automate your workflow by integrating with your favorite tools, such as Agility CMS!
Our integration with Vercel will set the environment variables that allow you to connect to your data from Agility CMS in your Vercel applications. In addition, it will also configure your Agility CMS instance with a preview and production domain, which enables direct links for your editing team.
You can deploy our template starters using the Vercel integration built-in to the Agility CMS Manager.
Start by heading into Settings > Sitemaps, then clicking Setup Deployment.
Select the Vercel Automated Deployment option to connect to Vercel and deploy your website.
First, create a Git Repository for your project to ensure you can easily update your project after deploying it.
Next, Install the Agility CMS integration that will authorize access between Vercel and your Agility CMS content so that we can automatically configure your Production and Preview domains, as well as set up your Environment Variables.
Lastly, Vercel will fetch the source code for the template starters and it will be cloned into your Git repository. Vercel will also build your project and upload/deploy your build output.
Once deployed you will be taken back to your Agility CMS Manager, and you will see that your Production and Preview domains have been set. You can click on the link to view your live site.
On the GitHub repositories for our starter templates, you will notice a Deploy to Vercel button. This button will create an instance in Agility, and automatically deploy it to Vercel, also configuring the necessary environment variables for you.
Vercel provides a frictionless experience that handles all of the hard things for you:
Vercel is an all-in-one platform for frontend frameworks, supporting the best of both worlds with static and hybrid deployment options, as well as providing dynamic computations with the use of serverless functions.
Upon clicking the button, you will be taken into the deployment flow.
First, to ensure you can easily update your project after deploying it, a Git repository must be created.
Next, you'll need to add the Agility CMS Integration.
When you add the integration, you'll be prompted to sign in or sign up.
After creating a new account or logging into your existing account, you will be able to create a new Agility CMS Instance.
When your Agility CMS Instance is created, you will be able to click to open your new Instance or click OK to continue with the deployment process.
Once the Agility CMS Integration has been added successfully and your instance has been created, Vercel will deploy your project, automatically configuring any necessary environment variables.
To add our Integration, search for the Agility CMS Integration in the Vercel Marketplace, then click on Add Integration.
You will then be asked to select a Vercel Scope to add the Integration to, select your Personal Account or your Vercel Team.
Next, select the Projects to which the Integration will be added.
Selecting Specific Projects will apply the environment variable values from a Single Instance to the Selected Project. You will most likely want to select this option.
Selecting All Projects will configure and apply the environment variable values from a Single Instance to ALL of your Vercel projects. This will overwrite any existing Agility CMS environment variables that you may have already set on these projects.
This option may be useful if you plan on using multiple environments, e.g. DEV, QA, UAT, PROD.
Login or Sign Up to Agility CMS.
After authenticating with Agility CMS, select an Instance to apply environment values from.
After adding the Agility CMS Integration to your Vercel project(s), you will be able to manage the Integrations access and permissions from your Vercel Dashboard.