01 / Setup
Getting started
- Install Wasil on your iPhone.
- Open the app and tap Get Started.
- Choose Default Mode or Private Mode.
- Create a Vercel personal access token at vercel.com/account/tokens, then paste it into Wasil.
- Wasil validates the token and loads your account, workspaces, and projects.
02 / Access
Required Vercel permissions
Use the smallest set of permissions that supports the actions you want to perform. Confirm the current names and availability in Vercel when you create the token.
| Permission | Why Wasil requests it |
|---|---|
user | Identify the connected Vercel account. |
team | List workspaces and teams. |
project | Read project metadata and status. |
deployment | Read deployment history and request redeploys. |
domain | Read domain and verification status. |
env | Read environment-variable keys and target coverage. Wasil does not fetch secret values. |
03 / Choose
Connection modes
Default Mode
Default Mode sends your token to the Wasil backend for validation. The backend stores the Vercel credential encrypted at rest and makes Vercel API requests on your behalf. The app stores only an opaque Wasil session token in the iOS Keychain.
Private Mode
Private Mode stores your Vercel token in the iOS Keychain and sends Vercel API requests directly from your iPhone to api.vercel.com. The Wasil relay is not used for those requests. Relay-backed notification features are unavailable in this mode.
04 / Overview
What Wasil can do
- Browse workspaces, projects, and recent deployments.
- Inspect deployment status, commit context, and event logs.
- Request a redeploy.
- Review connected domains and their verification state.
- Review environment-variable key coverage across Development, Preview, and Production without exposing values.
- Save favorite projects locally.
05 / Security
Disconnecting and revoking access
Sign out in Wasil to clear the local credential and revoke the active Wasil session. To revoke the Vercel token itself, delete it from Vercel’s token settings. If you use Default Mode and want the stored connection removed, contact support and include the account email. Never include the token.
06 / Help