PRDCT-692: reshoot the Apps screenshots against today's UI

[Iamfle4ka]

Linear: PRDCT-692

Stacked on #1159, which renames the lifecycle, Kai and other app actions in the text around these images. Merge #1159 first; GitHub then retargets this one to main. Moving this commit onto #1159 gave one conflict, in getting-started step 6: this commit rewords the start of the sentence ("click Deploy in the wizard") and #1159 rewrites its end (Start opens no wizard). The resolved line is the merged one that the Streamlit reshoot branch already carried.

Why

Seven Apps screenshots showed the UI from July or March: Redeploy App and Start App buttons, the Kai Agent Beta pill, the old Start Data App dialog, and an Overview tab with the App URL below Authentication. The text next to them already describes today's Deploy, Redeploy and Start and the collapsed Deploy settings section, so the pictures and the text disagreed.

What changed

All new shots come from the demo project 264 on europe-west3, taken at 2x: app-actions-menu.png on 6 October, the rest on 1 October. Each is cropped to the part of the UI its step points at, and person names in the Versions panel are blurred.

• deploy-wizard.png (new): the Deploy wizard of an app that has never run. It replaces deploy-timeout-backedsize.png in getting-started step 6 and publish-and-share step 1.
• redeploy-wizard.png (new): the Redeploy wizard of a running app, with Deploy settings collapsed, for reference "Sleep and resume".
• app-actions-menu.png: a stopped app's header with Open and the ⋮ menu open (Duplicate with Kai, Automate, Debug mode, Delete app). Reference "App actions" now uses it too, in place of the March manage-redeploy.png panel. The open menu covers Start and Edit with Kai at any window width, because both sit right-aligned under it. The 1 October take still showed the header's old Open App, so commit 07710cc retakes it on the same app, Toy Store Sales Dashboard (App ID 74016144, stopped before and after; the only click was the ⋮ trigger).
• build-in-ui-config.png: a new Python/JS app's Overview, Not Deployed, with the App access card. Used in getting-started step 5 and authentication Step 1.
• streamlit/lock-start-data-app.png and streamlit/lock-update-dependencies.png: the Start wizard of a Streamlit app, and the Redeploy wizard expanded to show the Update packages dependencies switch.
• streamlit/lock-freeze-version-toggle.png: the Packages card with Freeze Version on. It wasn't on the original list; it was taken while freezing was on for the shot above.
• deploy-timeout-backedsize.png and manage-redeploy.png are deleted; nothing references them now.

Text changes:

• Every changed image has new alt text that describes what it shows.
• authentication: the App URL block is in the App access card, above Authentication (the page said below), and the card's Not deployed yet notice can be ignored there.
• getting-started step 6 and publish-and-share step 1 tell you to click Deploy in the wizard.
• authentication, troubleshooting, getting-started and build-locally (commit a67e018) now name the Password field in the App access card on the Overview tab as a place to copy a Basic (Password) app's password, beside the dialog that Open in the page header shows. Steps that open the app keep the dialog only. The troubleshooting line also says what to do when the card asks you to start or redeploy the app instead of showing the field. The source comment in build-locally no longer says a stopped app's page shows no password; on 6 October the card showed it on the stopped Toy Store app.
• lock-version uses the UI's label, "Freeze Version" (not "Freeze versions"), and says it's in the Packages card. The wizard shots sit under their steps, the Packages card is shown as it looks after the first start, section 3 gets the confirm step, and a new sentence says what to do when the Update packages dependencies toggle is missing.

Also masked: the old streamlit/lock-update-requirements.png showed a colleague's name three times in its Versions panel. So does a byte-identical copy at lock-streamlit-version/code-deployment/update-requirements.png, which no page uses but help.keboola.com still serves. Both now have the name blurred (PRDCT-616 rule). The same two files are also on their own branch off main (PRDCT-616-mask-streamlit-name), so a small PR can take the name off the live site before this stack lands.

How the shots were taken

Some states only appear on an app that is in them, so two changes were made in project 264, both approved by Nikita:

• A new app, docs-manual-app (App ID 74022487), created with "Deploy from your own Git repository" and connected to the public keboola/titanic-python-app repository, branch main. It has never been deployed. It provides the plain Deploy wizard and the Not Deployed page: the two never-deployed apps Kai built both have drafts, so their wizard shows a draft box and a Deploy draft changes button. The app stays until this PR merges.
• docs-test-oidc-google (App ID 74021824, Streamlit): Freeze Version turned on, started once, shots taken, suspended with Suspend app, Freeze Version turned off again. The dependencies switch only shows after such a start.

Everything else was read-only: pages loaded, and menus and wizards opened and closed without submitting.

Evidence

On 1 October a logged-in europe-west3 project page loaded kbc-ui/bundle.CF29sTZY.js, which imports app-QW9Ajcyu.js. The chunks are public on ui.keboola-assets.com.

• CredentialsModal-DKVAbjxh.js: an app in state created gets the fields directly. Otherwise the wizard shows one sentence ("Starts the app with its current version and the settings below.", or "Restarts the running app…" when it runs) and a collapsible Deploy settings section whose summary is version · size · "Sleeps after N". The Update packages dependencies switch renders only when parameters.dataApp.freezeDependencies is true and state.data_app["requirements.txt"] exists. On the Streamlit test app that state key appeared after one start with freezing on.
• Detail-rhJ8jrVk.js: the Packages card's switch is labelled "Freeze Version", and the App access card holds the not-deployed notice, the App URL and Authentication.
• StatusLabel-v2pya8eH.js: Duplicate with Kai for apps with a Keboola-managed repository, Copy app otherwise, and Suspend app only while the app runs; created reads Not Deployed.
• The branch picker in Git Repository lists commit authors, so it isn't open in any shot.

On 6 October the page loaded kbc-ui/bundle.BeQYTX6g.js (app-DYO4ae3t.js). The Apps sources cited below are byte-identical to the 2 October build's (bundle.DZIl0CMv.js); only Builder/kaiPrompts.ts changed, adding two Kai prompts for drafts.

• OpenDataApp.tsx (in TerminateDataApp-DvAPVWPU.js): the header button reads Open, with the tooltip "Open the production app in a new tab", on any app that has been deployed. It always opens the Open app dialog first. Only the Apps list's inline link and Kai's chat card still say Open App.
• AppUrlSetting.tsx (in Detail-CzluuVsX.js): the App access card shows the Password field (hidden, with eye and copy, plus Reset for people who can edit the app) whenever the saved authentication is Basic (Password) and a password exists. It doesn't check whether the app runs. Without a password yet, the card asks you to deploy, start or redeploy the app to generate one.

Checks

• npm run build: clean, 373 pages. node scripts/audit-phase2.mjs: 0 broken links and 0 missing images, and its output is identical to the parent branch's.
• Brightness: mean luma 241 to 247 on all seven new images.
• fact-checker: 0 critical, 0 major, 15 claims confirmed against the build. Its one minor finding is the covered header buttons noted above. A second, narrow pass covered the text added after the reviews (the alt details, "click Deploy in the wizard", lock-version's confirm step and missing-toggle sentence, the Not deployed yet note): 0 critical, 0 major, 18 confirmed. Its three minors are applied: the Packages card now appears after the first start, the missing-toggle sentence says to reload the page, and authentication says "a notice such as Not deployed yet".
• guide-tester (cold read): no blockers. Its in-scope points are applied (the confirm step, the missing-toggle sentence, the wizard shots under their steps, the Not deployed yet note, the alt details). The rest predates this PR and is listed below.
• checker: PASS. Its five minor points from the first pass are applied (the separate masking branch, a second fact-check pass, clearer link text, the sibling's new tip, the merge order), and it passed the follow-up edits as well.
• The Kai wording from PRDCT-692: describe the Apps actions the way the UI shows them #1159 matches the header and menu shot, and since 07710cc so does the header button. Commit fffd9c1 makes the shot's alt text name the ⋮ menu, as the shot shows it; it said ⋯. After the move onto PRDCT-692: describe the Apps actions the way the UI shows them #1159: build clean, check-cli-reference 0, audit-phase2 0 broken links and 0 missing images, docs-link-redirect-check 0 blockers.
• The 6 October commits (07710cc, a67e018): build clean, 373 pages. The audit-phase2 output is identical to the 2 October baseline (0 broken links, 0 missing images), check-cli-reference finds 0, and the new shot's mean luma is 242.7. A chained git merge-tree simulation is clean for main, PRDCT-692: describe the Apps actions the way the UI shows them #1159, this PR, PRDCT-692: point "Share with your team" at the App access card #1165, PRDCT-692: describe today's Create app screen in Create an app manually #1166, PRDCT-692: reshoot the Streamlit screenshots and drop stray Apps images #1167, PRDCT-692: say when visiting a sleeping app no longer wakes it #1168, PRDCT-692: Apps fixes from a first-time reader's walkthrough (sample data without CSV Import) #1160, PRDCT-694: drop search-tuning spans from the markdown twin #1156, PRDCT-692: kbagent PATH step and the Free Plan stack (first-time reader's walkthrough) #1162 and PRDCT-692: open links that leave the docs in a new tab, marked ↗ #1161 in that order, and for each of PRDCT-692: point "Share with your team" at the App access card #1165 to PRDCT-692: say when visiting a sleeping app no longer wakes it #1168 merged straight onto this tip.
• fact-checker on those commits: 0 critical, 0 major, 23 claims confirmed against the build's source. Its one minor (Reset shows only for people who can edit the app) is fixed in the source comment.
• guide-tester on them (cold read): no blockers or majors. The troubleshooting sentence about a card that asks you to start or redeploy came from it, and two of its notes are under Not in this PR.
• checker on the two commits, the shot and this description: PASS. Its minors were the Evidence line about the 2 October build, now exact, and the Suspend/Resume wording, now listed below.

Not in this PR

• lock-version still says Start opens a wizard, in two places: step 2 of Enable version freezing, with a shot of the Start wizard, and step 3 of Updating package dependencies. That contradicts step 6 of getting-started in this PR, and PRDCT-692: describe the Apps actions the way the UI shows them #1159. PRDCT-692: reshoot the Streamlit screenshots and drop stray Apps images #1167 fixes both, so merge it soon after this one.
• getting-started "Create an app manually" steps 1 to 4 and build-in-ui-create.png still describe the old Create App screen. PRDCT-692: describe today's Create app screen in Create an app manually #1166 rewrites them.
• publish-and-share "Share with your team" and publish-config.png still describe the July Overview. PRDCT-692: point "Share with your team" at the App access card #1165 points them at the App access card.
• lock-version's two requirements screenshots and the Streamlit overview's March images are still from the old UI. PRDCT-692: reshoot the Streamlit screenshots and drop stray Apps images #1167 reshoots them.
• getting-started-deployed.png, above the password sentence in getting-started, is still the July page: Open App in the header and no App access card. Kai's chat card in it still reads Open App today, but the page beside it doesn't. A retake needs a fresh Kai build and publish.
• reference.md doesn't describe the App access card or its Password field, though four pages now send readers there.
• reference.md "Sleep and resume" still opens with "The Suspend/Resume feature", while App actions on the same page calls the menu item Pause app and the UI talks about sleep mode.
• authentication Step 1 doesn't say to choose the authentication type before looking for Callback URL (the field shows only for OIDC, GitHub, GitLab and JumpCloud), and getting-started step 4 doesn't say how to connect a repository.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
connection-docs	Ready	Preview	Oct 6, 2026 5:02pm UTC

[linear-code]

PRDCT-692

[keboola-pr-reviewer-bot]

Verdict: needs_human (risk 3/5) · profile connection-docs

Escalating: this content PR is stacked on unmerged #1159 and carries a self-admitted screenshot/UI mismatch, both gate-1 timing signals.

Impact flags: possible rollback re-introduction — see Check Run summary.

Concerns:

• src/content/docs/data-apps/publish-and-share.md: Stacked on unmerged #1159; depends on its text, merge order required
• src/content/docs/data-apps/publish-and-share.md: Alt text says 'Open App' but shipped UI button is now 'Open'
• src/content/docs/data-apps/reference.md: app-actions-menu.png shows stale 'Open App' header per PR body

Suggested reviewers: @keboola/docs