{"schemaVersion":"1","contentVersion":"2026-11-01.13","slug":"feedback-board","title":"Tutorial: Build a feedback board","summary":"Create a feedback board from a prompt, try it with sample data, and make your first improvement.","category":"Tutorials","minutes":8,"outcome":"A feedback board you can open in Preview, with a form, a saved list of ideas, and a status filter.","prerequisites":["A Rumata account with an active subscription. Follow [Set up Rumata](/guides/getting-started) if you have not signed in yet.","A project you can build in. Your private project normally appears in the Home project picker."],"sections":[{"id":"what-you-will-build","title":"What you’ll build","blocks":[{"type":"paragraph","text":"This optional tutorial applies the [four-step app-building guide](/guides/first-app) to a small app called Feedback Board. Someone submits an idea, the idea appears in a list, and you can mark it as planned. This is a starter exercise: use fictional feedback while you learn."},{"type":"paragraph","text":"The prompts below are examples, not a prebuilt template. Rumata may ask questions or produce a different layout. Use the checks in this guide to decide whether the result works. Build time depends on your request and workspace."},{"type":"table","headers":["You’ll use","What it does"],"rows":[["Home","Starts a new factory inside your selected project."],["Chat","Plans and builds your app, then makes changes."],["Preview","Lets you use the app before publishing it."]]}]},{"id":"describe","title":"1. Describe the app","blocks":[{"type":"steps","items":["Open [Home](https://app.rumata.dev/) and select your project below the prompt box.","Keep Plan selected. Paste the prompt below, then choose Send once.","Wait for the factory workspace to open. Confirm your message appears in the conversation."]},{"type":"code","language":"text","text":"Build an app called Feedback Board for collecting product ideas.\nStart with one page: a form with title and description, a list of saved\nideas, and a status for each idea: New or Planned. Let me change the\nstatus and filter the list by it. Save ideas so they survive a reload.\nUse fictional sample data. Keep the layout usable on a phone.\nPlan the smallest working version first. Do not publish it yet."},{"type":"note","title":"Check your result","text":"Your factory is open and your submitted request is visible in chat. An empty project picker or a disabled Send button means setup is not complete; follow [project selection](/guides/create-project#project) before continuing."}]},{"id":"review-plan","title":"2. Review the plan and build","blocks":[{"type":"paragraph","text":"Check that the plan includes the form, saved ideas, status changes, and a filter. For this first version, you do not need payments, email, or an external integration."},{"type":"steps","items":["Answer any questions in the workspace chat. If the plan includes extra features, ask Rumata to keep this version small.","When the plan matches your request, approve it using the offered chat controls or explicitly ask Rumata to build that plan.","Wait for the build to finish, then open Preview Mode."]},{"type":"note","title":"Check your result","text":"The feedback form and list render in Preview. A message saying the build finished is your cue to test the app yourself. If Preview cannot connect, use [preview troubleshooting](/guides/troubleshooting#preview)."}]},{"id":"test","title":"3. Submit one idea and check it stays saved","blocks":[{"type":"steps","items":["In Preview, submit an idea titled “Add a dark theme” with the description “Make the board comfortable to read at night.”","Confirm it appears once in the list with status New.","Change its status to Planned. Filter by Planned and confirm the idea is visible.","Reload Preview. Confirm the idea and its Planned status remain.","Switch the preview size to Mobile and repeat the form and filter actions."]},{"type":"note","title":"Check your result","text":"The idea persists after reload, the filter shows the right records, and the form works at the smaller width. If any check fails, report the exact action and result before adding more features."},{"type":"code","language":"text","text":"In Feedback Board Preview, I submitted “Add a dark theme” and changed\nits status to Planned. After reloading, the idea disappeared.\nI expected the idea and its status to stay saved. Please find the cause,\nfix it, and verify the same steps with sample data."}]},{"id":"improve","title":"4. Make one change","blocks":[{"type":"paragraph","text":"Once the basic task works, ask for one improvement. A focused request is easier to review and test than a long list of unrelated changes."},{"type":"code","language":"text","text":"Add a count beside each status filter so I can see how many ideas\nare New and Planned. Keep the existing records and behavior.\nVerify that each count updates when I change an idea’s status."},{"type":"steps","items":["Send the request in the same factory’s chat and wait for the change to finish.","Move one idea from New to Planned. Check that both counts change correctly.","Reload and repeat the original form-and-filter task to check that it still works."]},{"type":"note","title":"Check your result","text":"You can describe a change, inspect it in Preview, and verify it without starting a new factory."}]},{"id":"next-steps","title":"Next: get ready to share","blocks":[{"type":"paragraph","text":"You now have a first app to build on. Before real people use it, decide who can submit, read, and change feedback. Ask Rumata to implement those access rules and [test them with separate accounts](/guides/testing#access)."},{"type":"paragraph","text":"When the app is ready, follow [Publish your app](/guides/publishing). Publishing has its own review and verification steps; a working preview is not yet a live release."},{"type":"paragraph","text":"Want to see where the ideas are stored? Open [Database](/guides/system-explorer-database). Want to automate what happens after a submission? Try [your first workflow](/guides/first-workflow)."}]}],"technical":[],"related":["first-app","testing","publishing","first-workflow"],"sources":["content/guides/create-project.ts","content/guides/prompting.ts","content/guides/testing.ts","content/guides/databases.ts"],"updated":"2026-10-05","audience":"general","media":[],"video":null,"url":"https://docs.rumata.dev/guides/feedback-board"}