Skip to content

PRDCT-692: Apps fixes from a first-time reader's walkthrough (sample data without CSV Import) - #1160

Merged
Iamfle4ka merged 4 commits into
mainfrom
PRDCT-692-apps-first-run
Oct 8, 2026
Merged

Iamfle4ka merged 4 commits into
mainfrom
PRDCT-692-apps-first-run

Conversation

@Iamfle4ka

@Iamfle4ka Iamfle4ka commented Oct 6, 2026 •

Copy link
Copy Markdown
Collaborator

Linear: PRDCT-692

Why

On 4 October a first-time reader went through the Apps docs from zero: Free Plan sign-up, kbagent, then Build locally. He built an app, but stopped on the way at the sample data.

  1. He couldn't load the sample data. Both Apps "Before you start" boxes say to load opportunity.csv "as in Manual Data Loading", which links to /tutorial/load/#manual-data-loading. That page uses CSV Import. On us-east4, where Free Plan projects live, /v2/storage lists keboola.csv-import with the flags deprecated and excludeFromNewList, so the component search doesn't show it.
  2. What are apps lists "simulators" with one dashboard screenshot. The three example apps with screenshots are on the Apps overview, and nothing links there.

Two more stops were outside the Apps section: the kbagent PATH note and the Free Plan stack. They are in #1162.

What changed

Commit 194f5ee

  • data-apps/build-locally.mdx: load opportunity.csv with kbagent storage upload-table --project my-project --table-id in.c-sample.opportunity --file opportunity.csv. Readers of this page connect kbagent anyway, and the command creates the bucket and the table. The UI route is the HTTP data source connector, straight from the URL: base URL https://help.keboola.com/tutorial/, one row opportunity, path opportunity.csv. The sample prompt now says "the opportunity table" instead of in.c-csv-import.opportunity.
  • data-apps/getting-started.mdx (Build with Kai): download the CSV and attach it in Kai's chat. Get started with Kai documents this route: CSVs become tables in in.c-uploads-from-Kai, and Kai cannot open links.
  • Both sample CSV links get download. The file is served with content-disposition: inline, so a click opened it as text.
  • data-apps/what-are-apps.md: "Anything interactive" links to /data-apps/#beyond-dashboards.

Not in this PR

Checks

  • npm run build is clean.
  • docs-link-redirect-check: 0 blockers, 0 warnings. audit-phase2: 0 broken internal links, 0 missing images. kbagent storage upload-table is in the vendored kbagent reference.
  • The markdown twin of build-locally shows the command as plain text.
  • checker: PASS.
  • Test merges with git merge-tree: clean against current main, apps-action-labels (PRDCT-692: describe the Apps actions the way the UI shows them #1159), apps-app-access, apps-create-screen, streamlit-reshoot, apps-wake-disabled and PRDCT-487: Getting Started rerun on a Free Plan project, with a course-style hub and a 10-second clip #1144.
  • upload-table ran live on 6 October with kbagent v0.96.2, word for word as the page writes it (only the project alias changed), against a project that had neither the bucket nor the table: it created in.c-sample and in.c-sample.opportunity and imported 639 rows, as many as the CSV has, with 15 columns, in about 17 seconds. The page comment's VERIFY, one run of the sample prompt against that table, is still open.

🤖 Generated with Claude Code

@vercel

vercel Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
connection-docs Ready Ready Preview Oct 8, 2026 3:26pm UTC

Request Review

@linear-code

linear-code Bot commented Oct 6, 2026

Copy link
Copy Markdown

PRDCT-692

@Iamfle4ka
Iamfle4ka requested a review from MiroCillik October 6, 2026 12:35
@Iamfle4ka Iamfle4ka added the apps-ga Apps GA on 1 Oct 2026 — docs work tracked under AJDA-3380 label Oct 6, 2026
A first-time reader went from Free sign-up through Build locally on
2026-10-04 and stopped at loading the sample data: both Apps "Before you
start" boxes sent him to tutorial/load's Manual Data Loading, which uses
CSV Import. That component is deprecated and hidden from the component
search (flags deprecated + excludeFromNewList on us-east4).

- build-locally: load opportunity.csv with kbagent storage upload-table
  (the reader connects kbagent anyway), or in the UI with the HTTP data
  source connector straight from its URL. The sample prompt names the
  opportunity table instead of in.c-csv-import.opportunity.
- Build with Kai: attach the CSV in Kai's chat, the route the Kai docs
  document (Kai cannot open links).
- The sample CSV links download on click.
- What are apps: "Anything interactive" links to the three examples on
  the Apps overview; the page itself has one dashboard screenshot.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Iamfle4ka
Iamfle4ka force-pushed the PRDCT-692-apps-first-run branch from 09b5f1e to 194f5ee Compare October 6, 2026 13:25
@Iamfle4ka Iamfle4ka changed the title PRDCT-692: Apps fixes from a first-time reader's walkthrough (sample data without CSV Import, Free Plan stack, kbagent PATH) PRDCT-692: Apps fixes from a first-time reader's walkthrough (sample data without CSV Import) Oct 6, 2026
…the live run

The page's VERIFY(Nikita) asked for one run of the sample prompt against
the uploaded opportunity.csv. It ran on 2026-10-07 in project 264: an
agent with the dataapp-development skill and kbagent 0.97.0 took the
prompt word for word, built and deployed a Node app with a line chart,
and its startup query read 3 months and 639 rows.

Two findings:
- "the opportunity table" was ambiguous: project 264 has two tables with
  that name and the agent had to guess. The prompt now names
  in.c-sample.opportunity, and the sentence before it tells HTTP-route
  readers to put their own table's ID in its place.
- kbagent 0.97.0 `data-app create --use-managed-git-repo` left
  parameters.dataApp.git out of the config, so the app ran without a
  workspace until the agent added the block and redeployed. That is a
  kbagent bug, not a docs one; the comment keeps a VERIFY(Nikita) to
  re-run the prompt once it is fixed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- **Internal tools** — forms, approvals, and workflows that read and write back to your data.
- **Data narratives** — scrollable, explained stories built from your data.
- **Anything interactive** — configurators, simulators, and more.
- **Anything interactive** — configurators, simulators, and more. [Beyond dashboards](/data-apps/#beyond-dashboards) shows three real ones, with screenshots and live links.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really nice to see more uses

@Iamfle4ka
Iamfle4ka merged commit aa541f4 into main Oct 8, 2026
3 checks passed
@Iamfle4ka
Iamfle4ka deleted the PRDCT-692-apps-first-run branch October 8, 2026 15:28

This branch was successfully deployed

1 active deployment
Preview — fe7e0101 Deployed Oct 8, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

apps-ga Apps GA on 1 Oct 2026 — docs work tracked under AJDA-3380

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants