Netlify Integration
Connect Astrolabe to Netlify for deployment monitoring and site management
Netlify Integration
Connect your Netlify account to Astrolabe for native desktop access to site deployments, build logs, and configuration.
Features
- OAuth Authentication: Secure one-click connection (when OAuth is configured)
- Deployment Monitoring: Real-time build status and deploy previews
- Site Management: View and manage all your Netlify sites
- Build Logs: Access detailed build logs and error messages
- Deploy Triggers: Trigger new deployments from the desktop app
Prerequisites
- Astrolabe v0.1.12 or later
- Active Netlify account
- macOS 15.0 or later
Setup
Option 1: OAuth (When Available)
OAuth integration is supported but requires OAuth application setup.
Configure OAuth App
- Contact Netlify support to create an OAuth app
- Set redirect URI to:
astrolabe://oauth/callback/netlify - Add client ID to your
.envfile
Open Settings
Launch Astrolabe and navigate to Settings → Integrations.
Click "Link your Netlify account"
If OAuth is configured, click the button to authorize.
Authorize
Your browser opens to Netlify's authorization page. Review and authorize.
Complete Setup
Return to Astrolabe with your token saved securely.
Option 2: Personal Access Token (Current Method)
Generate Token
- Go to app.netlify.com/user/applications#personal-access-tokens
- Click "New access token"
- Give it a description like "Astrolabe Desktop"
- Click "Generate token" and copy it
Add to Astrolabe
- Open Settings → Integrations
- Find the Netlify section
- Paste your token in the Personal Access Token field
- Token is saved automatically
Usage
Linking a Site
Open Project
Navigate to your project in Astrolabe.
Click Netlify Button
In Service Integrations, click the Netlify button.
Select Site
Choose from your available Netlify sites.
Confirm
Click "Link Project" to establish the connection.
Viewing Deployments
Once linked:
- View deployment status on the project detail page
- Monitor build progress with real-time indicators
- Access site URLs for production and deploy previews
- View build logs when deployments fail or succeed
Triggering Deployments
Go to Project
Open your Netlify-linked project.
Find Deploy Actions
Look for the Netlify section in quick actions.
Trigger Deploy
Click "Deploy" or "Clear cache and deploy".
Monitor Progress
Watch the deployment status update in real-time.
Deployment Status
Astrolabe shows comprehensive deployment information:
- Build status: Building, ready, error, processing
- Deploy time: How long the build took
- Commit info: Associated git commit and message
- Branch: Which branch was deployed
- Deploy URL: Direct link to the deployed site
Troubleshooting
Token Authentication Fails
Issue: API calls return authentication errors.
Solution:
- Verify token is correctly copied (no extra spaces)
- Check token hasn't been revoked in Netlify dashboard
- Regenerate token and update in Astrolabe settings
Sites Not Loading
Issue: Site selector shows no sites.
Solution:
- Ensure you have sites in your Netlify account
- Verify token has full account access
- Check network connectivity
Deployment Status Not Updating
Issue: Status shows stale information.
Solution:
- Click refresh button to fetch latest status
- Check token permissions
- Verify site is still active in Netlify
API Reference
Astrolabe uses Netlify REST API:
- List Sites:
GET /api/v1/sites - Get Site:
GET /api/v1/sites/:site_id - List Deploys:
GET /api/v1/sites/:site_id/deploys - Trigger Deploy:
POST /api/v1/sites/:site_id/builds
Authentication via Bearer token in header.
Security
- Tokens are stored encrypted in Tauri plugin-store
- API calls only go to Netlify's official API
- No data is transmitted to third parties
- Deep links use secure
astrolabe://protocol when OAuth is enabled
Environment Variables
Optionally set environment variable:
NETLIFY_TOKEN=your_token_hereAstrolabe will use this if no token is set in the UI.
Support
Need help with Netlify integration?