{"schemaVersion":"1","contentVersion":"2026-11-01.13","slug":"publishing","title":"Publish your app","manual":true,"summary":"Review the exact source, website, backend services and workflow versions, then verify the released application.","category":"User Manual","minutes":7,"updated":"2026-11-01","outcome":"A reviewed live release whose website, API and required workflows work together.","prerequisites":["A tested application and the permissions and allowances needed to deploy its components."],"sections":[{"id":"prepare","title":"1. Prepare the tested version","blocks":[{"type":"paragraph","text":"Complete the main task in Preview and run the project’s checks. Identify the frontend, backend services, database changes and workflows that the release needs. A frontend build alone does not prove the whole application works."},{"type":"steps","items":["Fix failures and repeat the affected task.","Ask Rumata to prepare the intended changes and explain the source and components to release.","Resolve unfinished work before deployment review. Follow repository approval rules for commits and pushes."]},{"type":"code","language":"text","text":"Prepare the tested version for deployment review. Check the website, required backend services, workflows and data changes. Explain the source that will be built, test results, costs and anything unfinished. Do not deploy yet."},{"type":"note","title":"Check your result","text":"The intended application works in development and you understand what will be published."}]},{"id":"review","title":"2. Review the deployment","blocks":[{"type":"steps","items":["Choose Deploy in Preview, or open System Explorer → Frontend → Manage deployments.","Review the website address and source selection. A repository revision and a capture of current or retained workspace changes can contain different files.","Review the selected backend services, build/reuse choices, capacity and workflow versions. Check any database migration before deployment; development and production can share the bound database.","Choose Review & deploy and resolve warnings about public access, missing components, paid AI and capacity."]},{"type":"paragraph","text":"For backend-only work, manage the service in Services; you do not need to create a frontend just to publish an API or worker. A prebuilt image needs deployment but no source build."},{"type":"note","title":"Check your result","text":"The review identifies the intended source, addresses, service versions and workflow selections. Opening review does not publish them."}]},{"id":"deploy","title":"3. Deploy the reviewed components","blocks":[{"type":"steps","items":["Choose Deploy now only when the reviewed release is the one you intend to publish.","Follow Recent deployments through build, backend readiness, website publication and any required workflow activation. Queued, building and starting are provisional.","If a stage fails, inspect that stage and its logs before retrying. Check which version is still serving; do not assume all components changed together.","Resolve any workflow-activation warning and verify the required version before sharing the release."]},{"type":"paragraph","text":"Published services run independently of the development machine. A service configured for on-demand operation can sleep and wake later; an HTTP-disabled worker needs an appropriate runtime policy."},{"type":"note","title":"Check your result","text":"Required components report successful deployment, with no unresolved activation or readiness problem."}]},{"id":"live","title":"4. Test the actual live app","blocks":[{"type":"steps","items":["Open the public address returned by the deployment.","Complete the real customer task, including browser sign-in and the API call when the app has accounts.","Reload and verify saved data. Use two test users to check ownership and signed-out requests to check private endpoints.","For file features, verify a real upload and separate download. For asynchronous or AI work, follow completion and open the saved output.","Check the expected AI payer and limits using a small authorized request where applicable. Remove test data when safe."]},{"type":"note","title":"Check your result","text":"The website and its dependencies work at the released addresses, with the intended access rules. See [Release troubleshooting](/guides/troubleshooting#publish) if Preview and production differ."}]},{"id":"update","title":"Publish a later improvement","blocks":[{"type":"paragraph","text":"Repeat development, review and live verification for each release. Preview edits do not by themselves replace the published website or backend."},{"type":"list","items":["Use data migrations that remain safe for the serving version.","Review the selected source and component changes instead of assuming the latest build is active.","Keep a working serving version while investigating failed replacements."]},{"type":"paragraph","text":"Continue to [Manage your app](/guides/manage-project) after verification."}]}],"technical":[],"related":["backends","testing","troubleshooting","controls-frontend","agent-deployment"],"sources":["kondor_frontend/rumata_studio/src/components/deployments/FactoryDeploymentReview.tsx","rumata_full_stack/server/lib/controllers/frontend-production-deploy.controllers.ts","rumata_full_stack/server/lib/services/factory-release-source.ts","rumata_full_stack/server/lib/services/factory-backend-plan.ts","docs/devops/workspace-source-status.md","Application source reviewed at 9aaf95e3390696a9818af0ca4f23fa41869a4918, November 1, 2026."],"audience":"general","media":[{"src":"https://docs.rumata.dev/media/manual/collab-first-deployment.jpg","width":576,"height":468,"alt":"Collab Deploy Project dialog: Not Deployed, website address, 15 workflows to deploy, 0 already live, and Review deployment.","caption":"Collab before its first deployment: no release history and 15 workflows selected. The proposed website address is not proof of publication. No deployment was started for this capture.","sectionId":"deploy"},{"src":"https://docs.rumata.dev/media/manual/collab-paid-ai-review.jpg","width":576,"height":639,"alt":"Collab deployment review with the expanded Paid AI warning and a workflow requiring a signed-in caller with AI funding.","caption":"The real predeployment review identifies caller-funded AI. Review every warning and confirm payer and limits before selecting Deploy project; opening this review does not publish the application.","sectionId":"review"}],"video":null,"url":"https://docs.rumata.dev/guides/publishing"}