{"slug":"strategy/product-strategy/SITE_CONNECTIVITY_SPEC","title":"IntegrateWise — Site Connectivity Spec","section":"strategy","sectionLabel":"Strategy","status":"unclassified","type":"document","path":"strategy/product-strategy/SITE_CONNECTIVITY_SPEC.mdx","bytes":10510,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n> How all surfaces link to each other. One ecosystem, consistent navigation.\n\n---\n\n## The Five Surfaces\n\n| Surface        | URL                          | Repo               | Purpose                                                                 |\n| -------------- | ---------------------------- | ------------------ | ----------------------------------------------------------------------- |\n| Marketing Site | `integratewise.ai`           | integratewise-lg   | Public website — hero, solutions, pricing, CTAs                         |\n| Public Docs    | `docs.integratewise.ai`      | integratewise-docs | Product documentation — story, workspace, spine, connectors, reference  |\n| Internal Docs  | `int-docs.integratewise.ai`  | integratewise-docs | Team docs — product, GTM, architecture, operations, playbooks, runbooks |\n| Changelog      | `changelog.integratewise.ai` | integratewise-docs | Product updates, release notes, version history                         |\n| App            | `app.integratewise.ai`       | integratewise-live | The product — workspace, Twin, connectors, L2 overlay                   |\n\n---\n\n## Cross-Linking Map\n\n### From Marketing Site (integratewise.ai)\n\n| Link Location                             | Links To                | URL                                                                  |\n| ----------------------------------------- | ----------------------- | -------------------------------------------------------------------- |\n| Header nav → \"Docs\"                       | Public Docs home        | `docs.integratewise.ai`                                              |\n| Header nav → \"Changelog\"                  | Changelog home          | `changelog.integratewise.ai`                                         |\n| Header nav → \"Book a Demo\"                | Contact page            | `integratewise.ai/contact?intent=demo`                               |\n| Footer → Documentation                    | Public Docs home        | `docs.integratewise.ai`                                              |\n| Footer → API Reference                    | Docs reference section  | `docs.integratewise.ai/reference/depth-matrix`                       |\n| Footer → Changelog                        | Changelog home          | `changelog.integratewise.ai`                                         |\n| Footer → Blog                             | Blog page               | `integratewise.ai/blog`                                              |\n| Pricing → \"Book a Demo\"                   | Contact page            | `integratewise.ai/contact?intent=pricing`                            |\n| Any \"Sign in\" / \"Go to app\"               | App login               | `app.integratewise.ai`                                               |\n| Platform page → deep links                | Relevant docs pages     | `docs.integratewise.ai/spine/*`, `docs.integratewise.ai/workspace/*` |\n| Integrations page → \"How connectors work\" | Docs connectors section | `docs.integratewise.ai/connectors/how-connectors-work`               |\n\n### From Public Docs (docs.integratewise.ai)\n\n| Link Location                      | Links To                    | URL                                    |\n| ---------------------------------- | --------------------------- | -------------------------------------- |\n| Top nav → \"IntegrateWise\"          | Marketing site home         | `integratewise.ai`                     |\n| Top nav → \"What's New\"             | Changelog home              | `changelog.integratewise.ai`           |\n| Any \"Book a Demo\" CTA              | Marketing contact page      | `integratewise.ai/contact?intent=demo` |\n| Any \"Try it\" / \"Get started\"       | Marketing contact page      | `integratewise.ai/contact`             |\n| Footer → main site link            | Marketing site home         | `integratewise.ai`                     |\n| Connectors overview → full catalog | Marketing integrations page | `integratewise.ai/integrations`        |\n| \"Request a Connector\"              | Marketing contact page      | `integratewise.ai/contact`             |\n\n### From Internal Docs (int-docs.integratewise.ai)\n\n| Link Location                            | Links To                  | URL                          |\n| ---------------------------------------- | ------------------------- | ---------------------------- |\n| Top nav → \"Public Docs\"                  | Public Docs home          | `docs.integratewise.ai`      |\n| Top nav → \"Marketing Site\"               | Marketing site home       | `integratewise.ai`           |\n| Top nav → \"App\"                          | App                       | `app.integratewise.ai`       |\n| Top nav → \"Changelog\"                    | Changelog home            | `changelog.integratewise.ai` |\n| Any architecture doc → public equivalent | Relevant public docs page | `docs.integratewise.ai/*`    |\n\n### From Changelog (changelog.integratewise.ai)\n\n| Link Location              | Links To               | URL                        |\n| -------------------------- | ---------------------- | -------------------------- |\n| Top nav → \"Docs\"           | Public Docs home       | `docs.integratewise.ai`    |\n| Top nav → \"IntegrateWise\"  | Marketing site home    | `integratewise.ai`         |\n| Any feature mention → docs | Relevant docs page     | `docs.integratewise.ai/*`  |\n| Any \"Try it\" CTA           | Marketing contact page | `integratewise.ai/contact` |\n\n### From App (app.integratewise.ai)\n\n| Link Location               | Links To            | URL                                            |\n| --------------------------- | ------------------- | ---------------------------------------------- |\n| Help menu → \"Documentation\" | Public Docs home    | `docs.integratewise.ai`                        |\n| Help menu → \"What's New\"    | Changelog home      | `changelog.integratewise.ai`                   |\n| Footer → \"Back to Site\"     | Marketing site home | `integratewise.ai`                             |\n| Settings → \"API Reference\"  | Docs reference      | `docs.integratewise.ai/reference/depth-matrix` |\n| Onboarding → \"Learn more\"   | Relevant docs page  | `docs.integratewise.ai/workspace/how-it-works` |\n\n---\n\n## Shared Navigation Bar\n\nAll public-facing surfaces (marketing, docs, changelog) should have a consistent top-level awareness of each other. Not a shared header component (they're different repos/frameworks), but consistent link placement:\n\n**Marketing site header:**\n\n```\nLogo    Solutions    Platform    Pricing    Docs↗    Changelog↗    [Sign in]    [Book a Demo]\n```\n\n**Docs site header (already in VitePress config):**\n\n```\nLogo    The Story    Workspace    Spine    Connectors    What's New↗    IntegrateWise↗\n```\n\nUpdate \"What's New\" link from `integratewise-changelog.web.app` to `changelog.integratewise.ai`.\n\n**Changelog header:**\n\n```\nLogo    Changelog    Docs↗    IntegrateWise↗\n```\n\n**Internal docs header:**\n\n```\nLogo    [Internal sections]    Public Docs↗    App↗    Marketing↗\n```\n\nThe `↗` indicates an external link (opens in same tab, different subdomain).\n\n---\n\n## URL Updates Needed\n\n### integratewise-docs repo (VitePress config)\n\nIn `docs/.vitepress/config.ts`, update:\n\n```typescript\n// Current:\n{ text: \"What's New\", link: \"/changelogs/\" }\n\n// Change to (if changelog is a separate subdomain):\n{ text: \"What's New\", link: \"https://changelog.integratewise.ai\" }\n```\n\nAnd in the nav:\n\n```typescript\n// Current:\n{ text: \"IntegrateWise\", link: \"https://integratewise.ai\" }\n\n// Keep as-is — this is correct\n```\n\n### integratewise-lg repo (marketing site)\n\nIn `components/header.tsx`, add:\n\n```\nDocs → https://docs.integratewise.ai\nChangelog → https://changelog.integratewise.ai\n```\n\nIn `components/footer.tsx`, update:\n\n```\nDocumentation → https://docs.integratewise.ai\nChangelog → https://changelog.integratewise.ai\nAPI Reference → https://docs.integratewise.ai/reference/depth-matrix\n```\n\n### integratewise-live repo (app)\n\nIn the app's help menu or settings, add:\n\n```\nDocumentation → https://docs.integratewise.ai\nWhat's New → https://changelog.integratewise.ai\n```\n\n---\n\n## Consistent Branding Across Surfaces\n\n| Element       | Marketing Site         | Public Docs                                            | Internal Docs          | Changelog              | App                           |\n| ------------- | ---------------------- | ------------------------------------------------------ | ---------------------- | ---------------------- | ----------------------------- |\n| Logo          | IntegrateWise wordmark | IntegrateWise wordmark                                 | IntegrateWise wordmark | IntegrateWise wordmark | IntegrateWise logo + wordmark |\n| Primary color | Emerald `#1BA784`      | VitePress default (blue) — consider theming to emerald | Same as docs           | Same as docs           | Navy `#4154A3`                |\n| Font          | Inter                  | VitePress default (Inter if configured)                | Same as docs           | Same as docs           | Inter                         |\n| Footer        | Full 4-column          | VitePress default                                      | VitePress default      | VitePress default      | Minimal                       |\n\n**Recommendation:** Theme the VitePress sites to use emerald green (`#1BA784`) as the primary color to match the marketing site. This creates visual continuity when a visitor clicks from the marketing site to docs. The app stays navy blue — that's the working environment, different context.\n\nTo theme VitePress, add to `docs/.vitepress/theme/custom.css`:\n\n```css\n:root {\n  --vp-c-brand-1: #1ba784;\n  --vp-c-brand-2: #34d399;\n  --vp-c-brand-3: #6ee7b7;\n}\n```\n\n---\n\n## SEO and Meta\n\nEach surface should have proper meta tags that reference the others:\n\n**Marketing site:**\n\n```html\n<link rel=\"alternate\" href=\"https://docs.integratewise.ai\" title=\"Documentation\" />\n<link rel=\"alternate\" href=\"https://changelog.integratewise.ai\" title=\"Changelog\" />\n```\n\n**Docs site:**\n\n```html\n<meta property=\"og:site_name\" content=\"IntegrateWise Docs\" />\n<link rel=\"canonical\" href=\"https://docs.integratewise.ai/...\" />\n```\n\n**Changelog:**\n\n```html\n<meta property=\"og:site_name\" content=\"IntegrateWise Changelog\" />\n```\n\n---\n\n_Five surfaces. One ecosystem. Every link goes somewhere real. Every visitor can find their way from any surface to any other._\n"}