verceler is a CLI tool that simplifies and automates the process of deploying based on tags/releases to Vercel. It helps you automate trunk-based development and deploy through tags and releases.
To install verceler, you can use npm or yarn:
npm install -g verceleror
yarn global add vercelerAfter installing verceler, you can use it via the command line. Here are some common commands and options:
verceler -vt <vercel_token> -gt <github_token> [options]| Option | Description |
|---|---|
--vercel-token, -vt <token> |
Your Vercel API token. |
--github-token, -gt <token> |
Your GitHub API token. |
--create-github-workflow, -cgw |
Create a GitHub Actions workflow file for Vercel deployment. |
--debug, -d |
Enable debug mode to log extra information. |
--load-env, -le <envs> |
Comma-separated list of environments to set variables in Vercel projects (e.g., preview,development,production). |
--domain, -dom <domain> |
Domain name to set up with your Vercel project. |
verceler -vt your_vercel_token -gt your_github_token --create-github-workflow --load-env preview,development,production --domain yourdomain.comThis command will:
- Create a GitHub Actions workflow file for Vercel deployment.
- Install the Vercel CLI globally if not already installed.
- Link the project to Vercel.
- Load environment variables from .env.local and set them in Vercel for the specified environments.
- Set up the necessary GitHub secrets for Vercel deployment.
- Add the specified domain to your Vercel project.
We welcome contributions to verceler. To contribute, follow these steps:
- Fork the repository.
- Create a new branch for your feature or bug fix.
- Make your changes and commit them with descriptive messages.
- Push your changes to your fork.
- Submit a pull request to the main repository.
To run the test suite, use the following command:
yarn test --verbose --coverageThis will run all the unit tests and provide you with a coverage report. Make sure to write tests for any new features or bug fixes you add.
We follow standard JavaScript coding conventions. Please make sure your code adheres to these conventions before submitting a pull request.
verceler is licensed under the MIT License. See the LICENSE file for more details.
We hope verceler makes your Vercel deployments easier and more efficient. If you have any questions or feedback, feel free to open an issue or reach out to us.