Deployment
From within the Desktop app, you can one-click publish your generated artifact to Vercel as a live website.
Prerequisites
- A Vercel account with a configured provider ID.
- The deploy configuration set in Settings.
Configuration
Configure the Vercel deployment provider:
| Setting | Description |
|---|---|
| Vercel provider ID | Your Vercel provider ID, configured in Settings → Deploy |
| Deploy config | Project-specific deployment settings |
Internal Endpoints
The following endpoints are exposed by the running Desktop app's embedded runtime for in-app tools and the agent:
| Endpoint | Method | Description |
|---|---|---|
/api/deploy/config | GET | Get deploy configuration |
/api/projects/:id/deploy | POST | Deploy a project |
/api/projects/:id/deployments | GET | List deployments |
/api/projects/:id/deploy/preflight | POST | Run preflight checks |
Preflight Checks
Before deploying, TF Design runs a preflight check to verify:
- The artifact is valid and self-contained.
- All assets are inlined or accessible.
- No broken references or missing files.
- The deploy configuration is valid.
If preflight fails, warnings are displayed with details on what to fix.
Deploying a Project
- Open the project you want to deploy.
- Click Deploy (or use the deploy button in the preview toolbar).
- Review the preflight results.
- Confirm deployment.
- TF Design uploads the artifact to Vercel.
- A live URL is returned and displayed.
Managing Deployments
Each project maintains a list of deployments. You can view previous deployments, compare versions, and redeploy if needed.
Best Practices
- Run preflight first — always check preflight before deploying.
- Inline assets — ensure all CSS, fonts, and images are inlined or bundled.
- Test in preview — verify the artifact renders correctly in the sandboxed preview before deploying.
- Use the latest conversation — deploy from the most recent conversation to ensure the latest version.