Deployment
Deploy your documentation using the CLI, GitHub integration, or manual upload — with version history and rollback
Deployment
Specra Platform offers three ways to deploy your documentation: the CLI, GitHub integration, or manual upload. Every deployment goes through a pipeline with full version history and rollback support.
Deployment Methods
CLI Deploy
The fastest way to deploy. Build locally and push with a single command:
1specra deployThis builds your documentation and uploads it to Specra Platform. Make sure you're logged in first:
1specra loginGitHub Integration
Available on Pro and Enterprise plans. Connect a GitHub repository to automatically deploy on every push.
Connect Repository
Go to Project Settings > GitHub and authorize the Specra GitHub App.
Select Branch
Auto Deploy
Manual Upload
Upload a pre-built documentation bundle through the dashboard:
- Build your docs locally:
npm run build - Go to Project Settings > Deployments
- Click Upload Build and select your build output directory
Deployment Pipeline
Every deployment goes through four stages:
| Stage | Description |
|---|---|
| QUEUED | Deployment received and waiting to be processed |
| BUILDING | Building your documentation from source |
| DEPLOYING | Copying built files to the hosting infrastructure |
| RUNNING | Deployment is live and serving traffic |
You can monitor the current stage in real time from the Deployments tab in your project dashboard.
Build Logs
Full build logs are available for each deployment. Click on any deployment to view:
- Build output and warnings
- Deployment duration
- File count and total size
Version History
Every successful deployment is saved as a version. The number of versions retained depends on your plan:
| Plan | Version History |
|---|---|
| Free | 7 days |
| Starter | 30 days |
| Pro | Unlimited |
| Enterprise | Unlimited |
Rollback
You can roll back to any previous version within your retention window:
- Go to Project > Deployments
- Find the version you want to restore
- Click Rollback to this version
- The selected version is redeployed immediately
Deployment Notifications
Configure notifications to stay informed about deployment status:
- Email — receive an email when deployments succeed or fail
- Webhook — send deployment events to your own endpoint
Set up notifications in Project Settings > Notifications.
Troubleshooting
Deployment stuck in QUEUED? This usually resolves within a few minutes. If it persists for more than 10 minutes, try cancelling and redeploying.
Build failed? Check the build logs for errors. Common issues include missing dependencies, invalid configuration, or syntax errors in MDX files.
Rollback not available? Your version may have expired based on your plan's retention window. Upgrade your plan for longer (or unlimited) version history.