New Site Setup

This guide walks a new user through every step required to get a freshly added site fully operational in GeoBubbles.

Goal: at the end of this guide, your site has a configured domain, connected data sources, generated prompts, defined cities & competitors, and a first measurement cycle running.

---

Topics covered

1. Create the site (Domain details) — pick the right primary domain, set country/language locale, brand name & aliases, industry, and logo.
2. Brand configuration — canonical brand name vs short forms, brand aliases for entity matching, brand color, social handles.
3. Connect Google Search Console (GSC) — OAuth flow, property selection, initial sync (3/4/5-year window), monitoring & verification.
4. (Optional) Upload SEO keywords manually — when to use it, supported formats, dedupe rules, how manual keywords feed prompt generation.
5. Define competitors — why competitors are required for Share of Voice and Visibility Score, manual vs auto-suggested entries.
6. Choose target cities & geographic scope — single vs multi-city, local SERP & LLM queries, diacritic-insensitive matching.
7. Run the PromptDNA Wizard — 4-step wizard (seed → enrich → cities → review).
8. Review & curate generated prompts — approve, edit, delete, restore (soft-delete), quality classification.
9. Configure scoring & visibility focus — brand visibility focus %, Stealth mode, AIS / VS / SOV / TMR.
10. Trigger the first measurement cycle — manual run vs scheduled cron, expected runtime, batch jobs panel.
11. Verify the first results — dashboard KPIs, city map, prompt detail view, sanity checks.
12. Invite team members (optional) — read-only vs read/write roles, per-property assignment.
13. Set up automated reports & alerts (optional) — cadence, recipients, included sections.
14. Next steps — Insights, Visibility Gaps, Comp Radar, Stages Analytics.

Each topic above will get its own dedicated help article with screenshots and troubleshooting.