Client Deploy
Client Deploy is the place in the IDE Extension where you send your application's web client to Twinit. A web client is the set of pages people open in a browser.
This view is for you, the person building the app. From here you can:
- Upload a zip of the client
- Look at past uploads
- Open the site address
- Turn on deploy messages
- Choose who else may upload
Before you start
Developer support must approve client deployment for your application before you can use this view. The approval is for the application you are signed in to. A different application needs its own approval.
You must also be on the application's list of users allowed to deploy. Approval is for each person, not only for the application. If a teammate already deploys this application, they can add you to that list. You do not need to ask developer support again.
You also need to be signed in to Twinit. If you are not signed in, the view asks you to sign in first.
If you are not approved yet, the view tells you. It also shows a link named Request Access to Deploy Clients. Click that link to open the support site. Then ask developer support to approve deployments for your application.
Until you are approved, you cannot upload files or manage users in this view.
What to put in your access request
When you are not approved, the view also shows a box named Include this in your access request. It lists the details developer support needs:
- The Twinit environment address
- Your organization name and organization id
- The application name and application id
- Your email address
Click Copy to copy those details. The view shows Copied to the clipboard. Paste the details into your support ticket.
Also tell developer support the subdomain you would like. The subdomain is the first part of your site address. For example, in https://myapp.example.com the subdomain is myapp.
Opening Client Deploy
- Open the Support Center panel.
- Click Client Deploy.
A new tab opens in your editor. The title of the tab is Client Deploy. The view uses the environment and application you are signed in to right now.
How to read the web view
A web view is a page that opens inside your editor. It looks like a small website. The buttons on the page talk to Twinit for you, so you can stay in the editor while you work.
When the page first opens, you see Checking client deployment access... and a spinning circle. The view is looking up the application you are signed in to.
When the check finishes, the top of the page shows:
- Environment — the Twinit place you are signed in to.
- Application — the application this deploy is for.
- A short message that says whether you are approved.
If you are approved and a site address is ready, you also see Client URL. That is the web address of your deployed client. Click the address to open the site in your browser.
If you are not approved, you see Request Access to Deploy Clients instead of the file list and the user list.
When client deployments are disabled
Developer support may disable client deployments for an application. This is different from waiting for approval. An approved application can still have deployments turned off.
When deployments are disabled, the view shows this message under Client URL:
Client deployments have been disabled for this application. If this is in error, contact developer support.
You cannot upload or manage client files while deployments are disabled. The view hides:
- Subscribe to deploy notifications
- The uploaded files list
- Users Allowed to Deploy
If you think deployments were disabled by mistake, click Contact Developer Support. The link opens the support site where you can ask for help.
Subscribe to deploy notifications
Under the status message is a checkbox named Subscribe to deploy notifications.
Turn it on when you want an email each time a deploy happens for this application. Turn it off when you do not.
The checkbox stays off until your application is approved.
Confirm your subscription
Turning the checkbox on does not start the emails right away. You must confirm first.
- Turn on Subscribe to deploy notifications.
- Open your email. Look for a message with the subject New subscription created, please accept.
- Click Confirm Subscription in that email.
A page opens in your browser and tells you whether the subscription worked. After that, you get an email each time a deploy happens for this application.
Stop the emails
To stop the emails, turn off Subscribe to deploy notifications.
You can also click Unsubscribe in any deploy email. The next time you open Client Deploy, the checkbox is off.
Your uploaded files
This part of the page appears only after your application is approved.
Create the client zip
Make the zip before you upload. The zip should hold the finished client, not your source code.
- Open a terminal in your client project.
- Run the build command for that client. Use the build command your project already has.
- When the build finishes, find the files it created.
- Zip those files. That zip is the file you upload.
If you are using AI to help you build your client application, any agent should be able to help you complete these steps or even complete them for you.
Upload a zip
Click Upload zip and choose the zip you just made. A zip file is one packed file that holds your client.
A bar shows how far the upload has gone. When it finishes, the file shows up in the list. The view then shows Waiting for the site to update… and checks the site every few seconds. When the site is ready, that message goes away and the file list shows which file is deployed. If the site does not update, the view stops waiting after a few minutes and shows The site has not updated yet.
You can upload only one zip at a time. If you pick a file that is not a zip, the view shows an error and does not upload it.
If you upload a zip that already has the same name, Twinit saves it as a new version. A version is a newer copy of the same file. The newest version is the one shown on the main row.
The file list
Each row tells you about one uploaded file.
| Column | What it means |
|---|---|
| Name | The file name |
| Version | The newest version number |
| Updated by | The person who uploaded that version |
| Updated at | The date and time of the upload |
| Size | How big the file is |
| Actions | Buttons to download or delete |
If you have not uploaded anything yet, the view says No files uploaded yet.
Long lists are split into pages of 10. Use Previous and Next to move through them. A label tells you which rows you are seeing, such as "Showing 1–10 of 24".
How the current deploy is shown
A line above the file list starts with Deployed. It shows:
- The name of the deployed zip
- The deployed version number
- The date and time it went live
The matching row in the list is shaded and has a Deployed badge next to the file name.
The deployed version may not be the newest version. When this happens, the main file row shows a note such as v2 deployed. Click the arrow next to the file name to open its older versions. The deployed version is shaded and has the Deployed badge.
If the deployed file or version is no longer in the uploaded files list, the line above the list still tells you what is live. It also tells you that the file or version is missing from the list.
If nothing has been deployed yet, the Deployed line and badges do not appear.
Older versions
If a file has more than one version, a small arrow sits next to its name.
Click the arrow to open the older versions. Each older version has its own row, with the same details as the main row. Click the arrow again to hide them. If there are many versions, use Previous and Next under that file.
Download
Click the download icon on a row to save a copy of that file or that version.
If a download is not ready, the download icon is gray and cannot be clicked.
Delete
Click the trash icon to delete. The editor shows a warning before anything is removed.
- Deleting one version removes only that version. This cannot be undone. Twinit then deploys the newest version that is still left.
- If no versions are left, the site that is already live stays as it is. Nothing new is deployed.
- Deleting the main file removes that file and every version. This cannot be undone. Because no versions are left, the live site stays as it is.
Choose Delete only when you are sure. If you close the warning, the file stays.
Users allowed to deploy
This part of the page appears only after your application is approved. The heading is Users Allowed to Deploy.
These are the people who may upload the client for this application.
Add a user
- Type the person's email in Add User by Email.
- Click Add User. You can also press Enter.
The person must already have a Twinit account. If the email is missing or does not look like an email address, the view asks you to fix it.
Remove a user
Each person appears in a small pill with their name. Hover over a pill to see that person's email. Your own pill says (self). You cannot remove yourself.
To remove someone else, click the trash icon on their pill. The editor asks you to confirm. Removing them cannot be undone. They will no longer be allowed to deploy this application.
Closing the view
Click Close at the bottom of the page to close the tab. You can open Client Deploy again any time from the Support Center panel.