Deploy to Vercel
Deploy your CamelMind documentation site to Vercel in minutes.
Vercel makes it easy to deploy your CamelMind documentation site. It automatically builds and deploys your site on every Git push, provides HTTPS out of the box, and creates preview deployments for pull requests.
You'll need:
- A CamelMind documentation project
- A GitHub repository containing your project
- A Vercel account
Deploy your site
Push your project to GitHub
Commit your project and push it to a GitHub repository.
git add .
git commit -m "Initial commit"
git push
If you haven't created a repository yet, create one on GitHub first, then push your project.
Import the repository into Vercel
- Sign in to Vercel.
- Select Add New → Project.
- Choose your GitHub repository.
- Click Import.
CamelMind is built on Next.js, so Vercel automatically detects the project and configures the build settings.
Configure environment variables
Before deploying, configure your project's environment variables.
| Variable | Description |
|---|---|
CAMELMIND_URL | The public URL of your documentation site. |
SESSION_SECRET | Required when authentication is enabled. |
If you're using OpenID Connect (OIDC), also configure:
OIDC_ISSUEROIDC_CLIENT_IDOIDC_CLIENT_SECRET
See Environment Variables for the complete list of supported variables.
Deploy
Click Deploy.
Vercel builds and publishes your documentation site. Once deployment completes, your site is available at its public URL.
Every future push to your default branch automatically triggers a new deployment.
Use a custom domain
To use your own domain:
- Open your Vercel project.
- Go to Settings → Domains.
- Add your domain and follow the DNS instructions.
- Update
CAMELMIND_URLto match your new HTTPS URL.
Preview deployments
Every pull request automatically receives its own preview deployment.
This allows reviewers to browse documentation changes before they're merged into your main branch.
Troubleshooting
The build fails
Verify that all project dependencies are committed to your repository.
If you've recently installed new packages:
npm install
git add package.json package-lock.json
git commit -m "Update dependencies"
git push
Authentication redirects to the wrong URL
Verify that CAMELMIND_URL exactly matches your site's public HTTPS URL, without a trailing slash.