Platform Integrations
Connect Astrolabe to Vercel, GitHub, Cloudflare, and more
Coming in v0.4.0
Platform integrations are currently in development and will be available in version 0.4.0. This page describes the planned functionality.
Connect Astrolabe to your favorite deployment platforms and development tools. Manage deployments, monitor status, and control your infrastructure—all from one dashboard.
Supported Platforms
Deployment Platforms
Vercel
Features:
- View all projects and deployments
- Monitor build status and logs
- Manage environment variables
- View domains and DNS settings
- Rollback to previous deployments
- Trigger new deployments
Cloudflare Pages
Features:
- Track deployments and build status
- View preview URLs for branches
- Manage environment variables
- Monitor Workers status
- Check analytics and usage
Netlify
Features:
- Monitor sites and deployments
- View build logs and errors
- Manage forms and submissions
- Check function logs
- View bandwidth usage
- Configure deploy hooks
Render
Features:
- View services and deployments
- Monitor deploy logs
- Manage environment groups
- Check health status
- View resource usage
Railway
Features:
- Monitor projects and services
- View deployment status
- Manage databases
- Check logs and metrics
- View usage and billing
Fly.io
Features:
- Monitor apps and machines
- View deployment logs
- Manage secrets
- Configure regions
- Check scaling status
Development Platforms
GitHub
Features:
- View repository information
- Monitor pull requests
- Track issues and labels
- Check Actions status
- View workflow logs
- See recent commits
GitLab
Features:
- View projects and groups
- Monitor merge requests
- Track CI/CD pipelines
- View issues and milestones
- Check deployment status
Setting Up Integrations
Obtain API Token
Each platform requires an API token for authentication. Get your tokens from:
- Vercel: Account Settings → Tokens
- Cloudflare: Profile → API Tokens
- Netlify: User Settings → Applications
- GitHub: Settings → Developer Settings → Personal Access Tokens
- Railway: Account → Tokens
- Fly.io: Account → Access Tokens
Token Permissions
Ensure your API token has read access at minimum. Write access is optional and only needed for operations like triggering deployments or managing environment variables.
Add Token to Astrolabe
- Open Settings → Integrations
- Select the platform you want to connect
- Click Add Token
- Paste your API token
- (Optional) Give the connection a name
- Click Verify to test the connection
- Click Save
Link Projects
After adding a token, link your Astrolabe projects to platform projects:
- Open a project in Astrolabe
- Click Integrations tab
- Click Link to [Platform]
- Select the corresponding project from the platform
- Click Link
Astrolabe attempts to auto-match projects by name and git URL. Verify the match before linking.
Using Integrations
View Deployment Status
Once linked, see deployment status directly in project cards:
- 🟢 Deployed - Latest deployment successful
- 🟡 Building - Deployment in progress
- 🔴 Failed - Latest deployment failed
- ⚪ Not Deployed - No deployments
Click on the status to:
- View deployment logs
- See build details
- Open live URL
- Check environment
Monitor Multiple Projects
The Dashboard shows an overview of all connected projects:
- Recent deployments across all platforms
- Failed builds requiring attention
- Currently building projects
- Deployment frequency charts
Quick Actions
Perform platform actions from Astrolabe:
Vercel:
- Redeploy latest commit
- Rollback to previous deployment
- Open dashboard
- View domains
Netlify:
- Trigger new deploy
- Clear cache and redeploy
- View deploy logs
- Open site settings
GitHub:
- Open repository
- View latest PR
- Check Actions status
- See recent commits
API Token Security
Your API tokens are stored securely:
- macOS: Keychain
- Windows: Credential Manager
- Linux: Secret Service API (libsecret)
Best Practices:
- Use tokens with minimal required permissions
- Rotate tokens periodically
- Revoke tokens if compromised
- Never share tokens or commit them to git
Troubleshooting
Connection Failed
"Invalid API token"
- Verify the token is correct and hasn't expired
- Check token permissions
- Try regenerating the token
"Cannot reach API"
- Check your internet connection
- Verify the platform service is operational
- Check if you're behind a proxy or firewall
Projects Not Linking
"No matching projects found"
- Ensure you have projects on the platform
- Verify the API token has access to those projects
- Try refreshing the project list
"Git URL mismatch"
- Check that your local git remote matches the platform
- Update git remote:
git remote set-url origin <url>
Slow API Responses
- Rate limits may be affecting requests
- Large organizations with many projects take longer
- Try refreshing individual projects instead of all at once
Planned Features
Future integration enhancements:
- Bulk Operations - Deploy multiple projects simultaneously
- Notifications - Desktop alerts for deployment status
- Cost Tracking - Monitor usage and billing across platforms
- Workflow Triggers - Automatically deploy on git push
- Integration Webhooks - Real-time updates via webhooks
- Custom Integrations - Plugin system for additional platforms
Need Help?
- Check the FAQ for common questions
- Visit Troubleshooting for solutions
- Join our Discord for community support
- Report issues on GitHub