Deploying your application in Aha! Builder makes it available to the people who will use it. This article explains how to prepare for launch, deploy your application, configure its domain, publish updates, and revert to an earlier version if needed.
Prepare to deploy
Before you deploy, confirm that your application is ready for real use. Review the experience people will have, review access settings, and decide how you will respond if you need to revert after launch.
Test your main workflows in preview, including sign-in, common tasks, and saving changes.
Confirm that roles, permissions, and authentication settings match how people will use the application.
Decide who will use the application first and how you will share access when it goes live.
Review data sources and integrations so the application points to the right systems for production.
Check that navigation, labels, and field names are clear.
Confirm that performance is acceptable on the pages and workflows people will use most.
Run virtual user testing (Aha! Builder Team and Scale plans).
Decide how you will limit access or revert to an earlier version if you deploy too early or find a serious issue.
Once the application is ready for real users, you can move to production with more confidence. If you need to roll back after launch, you can revert to an earlier version.
Deploy an application
After your application is live, test changes in Preview before publishing them for users.
Open the application in Aha! Builder.
-
Select Production, then select Deploy updates.
Note: If Deploy updates is disabled and the status reads Deployed, there are no undeployed changes to publish. Make and save your changes in Preview first.
Publishing updates lets you improve the application over time.
Review undeployed changes
After you deploy an application, any edits you make in Preview stay there until you deploy again. Aha! Builder shows whether an application has undeployed changes so you can see exactly what will be published before you deploy.
-
Open the application in Aha! Builder and select Production. The Deploy to production panel shows the application's status.
Undeployed changes means you have edited the application in Preview since your last deployment.
Deployed means Preview and Production match.
Not deployed yet means the application has never been deployed.
-
Select View undeployed changes to review what will be published.
The Changes since last deploy window lists each change by the date it was created, its version, and a summary. Expand files changed to see the individual files that were modified since your last deployment.
-
Select Deploy for a first deployment, or Deploy updates for an application that is already live, to publish the changes.
Note: When there are no undeployed changes, the status reads Deployed and the deploy button is disabled. Preview and Production already match, so there is nothing to publish.
Reviewing what will change before you deploy helps you confirm that Preview and Production are in sync and avoid publishing unfinished work.
Configure an application domain
Choose the domain people will use to access your application. You can configure it before or after you deploy your application. With the Aha! Builder Team plan, you can use a custom Aha! subdomain for a faster launch. With the Aha! Builder Scale plan, you can configure a custom domain (CNAME) for a branded web address.
Open the application in Aha! Builder.
Select Production, then select Configure domain.
-
Choose a Domain type.
Subdomain: A unique prefix before the aha.host part of the URL, such as
yourapp.aha.host. This is a good option for internal tools or for teams that want to launch quickly.Custom domain (CNAME): Your own web address, such as
yourapp.yourcompany.com. You will need help from your IT team to set it up.
-
Enter the Subdomain or CNAME.
If you selected CNAME, copy the value below the CNAME field and share it with your IT team. They will add a CNAME record in your domain's DNS settings that points to it.
Select Update domain settings.
After you set the domain, confirm that people can reach the application as expected. You can then publish updates as you continue improving the application.
Deploy updates to an application
After your application is live, test changes in preview before publishing them for users.
Open the application in Aha! Builder.
Select Production, then select Deploy updates.
Publishing updates lets you improve the application over time.
Revert to an earlier version
If a deployment causes a problem, you can revert to an earlier version. This restores a version that worked as expected.
Navigate to Code -> History.
Select the rollback icon next to the version you want to restore.
Reverting gives you a recovery path if a deployment does not go as planned. After rollback, review the issue in preview before you deploy again.