Build / Windsurf / Watchlist monitor

How to Build a Watchlist Monitor with Windsurf and Synorb

Windsurf fits when the builder wants an IDE-native agent to modify a real app while preserving local structure. A watchlist monitor is a natural shape: entities, topics, source-linked updates, and review state.

What is this watchlist monitor supposed to do?

A watchlist monitor should let users save companies, issues, states, or source groups and see current updates with citations. The product value is reliable external context inside the workflow users already use.

Company watchlist

Track a set of companies with source-linked updates and tags.

Issue watchlist

Track state policy, market, regulatory, or industry topics.

Review queue

Let users approve, dismiss, pin, and export updates.

Why does Windsurf fit this build?

This build fits Windsurf because the agent can work inside an existing app, inspect surrounding context, and add a monitor without treating the repo like a blank canvas. Synorb supplies the current feed layer.

Builder surface
Windsurf builds the app layer
GoalWatchlist monitor
OutputUI, routes, filters, states, and review workflow
Context layer
Synorb supplies source-grounded feeds
BuildMCP exploration where available
ShipREST from a backend route with server-side secrets

Which Synorb feeds should this app start with?

Start narrow, prove the feed contract, then broaden coverage. These scopes give the coding agent concrete source-grounded examples to design against.

company tags

Use Synorb Streams and source-linked feed records to test this scope with source URLs, dates, tags, and coverage caveats preserved.

issue tags

Use Synorb Streams and source-linked feed records to test this scope with source URLs, dates, tags, and coverage caveats preserved.

statehouse updates

Use Synorb Streams and source-linked feed records to test this scope with source URLs, dates, tags, and coverage caveats preserved.

market intelligence feeds

Use Synorb Streams and source-linked feed records to test this scope with source URLs, dates, tags, and coverage caveats preserved.

source-grounded briefs

Use Synorb Streams and source-linked feed records to test this scope with source URLs, dates, tags, and coverage caveats preserved.

Use the same safe data path.

1

Explore with an agent

If Windsurf or your companion coding agent supports MCP, inspect Synorb Streams and source-linked examples before generating the app. Otherwise use the REST docs and the sample row shape in the prompt.

2

Call Synorb from the backend

The shipped app should call Synorb REST from a server route, scheduled job, webhook receiver, or server function. Keep SYNORB_API_KEY and SYNORB_SECRET out of browser code.

3

Show citations and coverage

Every card should preserve source URL, source name, published date, tags, and an honest empty or limited-results state when the selected scope has few results.

Paste this into Windsurf.

This prompt is tuned to the build intent and keeps Synorb credentials server-side.

Watchlist monitor prompt

Asks for the app surface, backend feed route, source-linked rows, safe credential handling, and transparent coverage states.

Use Windsurf to add a Synorb watchlist monitor to this app. Inspect the existing data model, routes, UI components, auth, and env handling first. Add a server-only route that reads SYNORB_API_KEY and SYNORB_SECRET from server-side secrets and calls POST https://api.synorb.com/streams/query for saved watchlist scopes. Build UI for watchlists, filters, latest updates, source-linked cards, review state, and export actions. Each item must include headline, summary, published date, source name, source URL, tags, and significance. Do not expose credentials to browser code. Add setup docs with curl -s https://synorb.com/connect.

Questions builders ask.

Can Windsurf add a Synorb monitor to an existing app?

Yes. Use Windsurf for codebase-aware edits and Synorb REST for the server-side feed.

What can a watchlist contain?

Companies, issues, states, source groups, tags, or other scopes that map to Synorb Streams and feed records.

How should watchlist items cite sources?

Show source URL, source name, published date, tags, and a stable ID near every summary.

Should this use direct browser calls?

No. Browser code should call your backend route. The backend route calls Synorb with server-side credentials.

Want to test Synorb feeds for free?

Provision starter credentials, then keep REST credentials server-side in the app you build.

curl -s https://synorb.com/connect