Developer docs

Build with OneStar

Developer docs for OneStar: put a Feedback form on your site or in your app, read answers through the REST API and webhooks, and connect an AI assistant.

Feedback: start

OneStar FeedbackForms, polls and NPS questions on your own site or app, with every answer counted by code next to your store reviews.QuickstartPut a form on a page in a few minutes: create it, allow your site, paste two lines, send a test answer.TestingTry a form on localhost, use test mode, and read the test answers that never count.With a coding agentLet Claude Code, Codex, Cursor or another assistant add a form through OneStar's MCP server: scopes, tools, the prompt and an AGENTS.md snippet.

Feedback: install

FrameworksThe element in plain HTML, React, Next.js, Vue, Svelte and Astro, with types for JSX.Native appsShow a form in an iOS, Android, React Native or Flutter app through a web view, and close it when the form is answered.Modes and triggersInline, popover, slide-in, modal and page modes, your own button, and timed, scroll and exit triggers.Feature boardsIdeas with votes, statuses and comments on your own site with mode="board": who may post, what readers see and the board's events.Allowed sites and securityAllowed sites, Content Security Policy lines, what the widget stores and what OneStar keeps.

Feedback: build on it

JavaScript APIwindow.onestar: open, close, identify, set, submit, threads and reply, with the queue that works before the loader.Events and errorsThe DOM events the element fires and the error codes onestar:error carries.Your own UISend answers from a form you draw yourself, with question and option ids from the builder or the API.Signed in usersSign a short lived token on your server so answers carry a verified user and traits, with Node and Python examples.Context and placementsTell OneStar the app version, platform, plan and cohort, name each placement, and read loads, starts and finishes per place.ThemingMatch your site with the form's tokens, CSS variables and parts.

Feedback: server

REST APISecret keys and the /v1/owner/ routes: forms, results with filters, answers and import.WebhooksSigned webhook events for new answers, replies and limits, and how to check the signature.Importing answersBring older answers in by CSV or through the API, checked like answers from the widget.

Feedback: reference

TroubleshootingWhat to check when a form does not load, an answer is refused or a token is ignored.Versions and changesHow the loader, the element and the API are versioned, and where changes are announced.

For AI assistants

Every page here is also plain Markdown: add .md to its address, or ask for it with Accept: text/markdown. llms.txt lists them all. The OneStar MCP server lets Claude, Codex, Cursor or another MCP client read your reports and forms on Pro and Max.