Tutorials

.env.sample

@@ -3,3 +3,5 @@ GATSBY_ALGOLIA_SEARCH_KEY=
 ALGOLIA_ADMIN_KEY=
 GATSBY_CLOUDFLARE_URL=
 BUILD_ENV=LOCAL
+
+

modules/ROOT/pages/common/nav-embedding.adoc

@@ -124,6 +124,8 @@ Customize and integrate
 Embedding tutorials
 
 * link:{{navprefix}}/tutorials/tutorials-overview[Embedding tutorials]
+
+////
 * link:{{navprefix}}/tutorials/tse-fundamentals/intro[Embedding Fundamentals]
 ** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-01[01 - Overview]
 ** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-02[02 - Set up for course]
@@ -142,8 +144,16 @@ Embedding tutorials
 ** link:{{navprefix}}/tutorials/react-components/lesson-02[02 - ThoughtSpot component pages]
 ** link:{{navprefix}}/tutorials/react-components/lesson-03[03 - Menus and navigation elements]
 ** link:{{navprefix}}/tutorials/react-components/lesson-04[04 - Event handling]
-* link:{{navprefix}}/tutorials/spotter/integrate-into-chatbot[Integrate Spotter into your Chatbot]
+//* link:{{navprefix}}/tutorials/spotter/integrate-into-chatbot[Integrate Spotter into your Chatbot]
+
+* link:{{navprefix}}/tutorials/react-components/intro[Introduction]
+** link:{{navprefix}}/tutorials/react-components/lesson-01[Initializing ThoughtSpot Embed SDK]
+** link:{{navprefix}}/tutorials/react-components/lesson-02[ThoughtSpot component pages]
+** link:{{navprefix}}/tutorials/react-components/lesson-03[Menus and other navigation elements]
+** link:{{navprefix}}/tutorials/react-components/lesson-04[Event handling]
 
+* link:{{navprefix}}/tutorials/spotter/integrate-into-chatbot[Integrate Spotter into your chatbot]
+////
 
 [.sidebar-title]
 Reference guides and changelog

modules/ROOT/pages/common/nav-release-notes.adoc

@@ -0,0 +1,17 @@
+
+:page-pageid: nav-release-notes
+:page-description: Release notes and changelogs
+
+[navSection]
+
+[.sidebar-title]
+Release notes and changelogs
+
+* link:{{navprefix}}/whats-new[What's new]
+* Changelog
+** link:{{navprefix}}/embed-sdk-changelog[Visual Embed SDK changelog]
+** link:{{navprefix}}/mobile-sdk-changelog[Mobile Embed SDK changelog]
+** link:{{navprefix}}/rest-v2-changelog[REST API v2 changelog]
+** link:{{navprefix}}/mcp-server-changelog[Spotter MCP Server changelog]
+* link:{{navprefix}}/deprecated-features[Deprecation announcements]
+

modules/ROOT/pages/common/nav-rest-api.adoc

@@ -38,8 +38,6 @@ REST APIs
 ** link:{{navprefix}}/webhooks-rest-api[Webhook APIs]
 
 
-
-
 [.sidebar-title]
 REST API SDK
 
@@ -50,14 +48,19 @@ REST API SDK
 * link:{{navprefix}}/rest-api-sdk-csharp[C# SDK]
 * link:{{navprefix}}/rest-apiv2-js[REST API v2.0 in JavaScript]
 
+
 [.sidebar-title]
 REST API Tutorials
 
 * link:{{navprefix}}/tutorials/rest-api/intro[REST API Tutorials]
+
+////
 * link:{{navprefix}}/tutorials/rest-api/lesson-01[01 - REST API overview]
 * link:{{navprefix}}/tutorials/rest-api/lesson-02[02 - Simple Python implementation]
 * link:{{navprefix}}/tutorials/rest-api/lesson-03[03 - Complex REST API workflows]
 
+////
+
 [.sidebar-title]
 REST API v1 (DEPRECATED)
 

modules/ROOT/pages/common/nav-tutorials.adoc

@@ -0,0 +1,51 @@
+
+:page-pageid: nav-tutorials
+:page-description: Tutorials navigation
+
+[navSection]
+
+[.sidebar-title]
+Embedding fundamentals
+
+* link:{{navprefix}}/tutorials/tse-fundamentals/intro[Introduction]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-01[Overview of ThoughtSpot Embedded]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-02[Setting up for the course]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-03[Security Setting]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-04[Start Coding]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-05[Embed Search]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-06[Embed Natural Language Search]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-07[Embed Liveboard]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-08[Embed Liveboard Visualization]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-09[Embed Application]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-10[Styling ThoughtSpot]
+* link:{{navprefix}}/tutorials/tse-fundamentals/lesson-11[Summary and Next Steps]
+
+[.sidebar-title]
+UI elements and style customization
+
+* link:{{navprefix}}/tutorials/style-customization/intro[Introduction]
+* link:{{navprefix}}/tutorials/style-customization/step-01[Getting started]
+* link:{{navprefix}}/tutorials/style-customization/step-02[Large component elements]
+* link:{{navprefix}}/tutorials/style-customization/step-03[CSS styles]
+* link:{{navprefix}}/tutorials/style-customization/step-04[Text strings and icon replacement]
+* link:{{navprefix}}/tutorials/style-customization/step-05[Menu items]
+* link:{{navprefix}}/tutorials/style-customization/step-06[Conclusion]
+
+[.sidebar-title]
+REST API tutorials
+
+** link:{{navprefix}}/tutorials/rest-api/intro[Introduction]
+** link:{{navprefix}}/tutorials/rest-api/lesson-01[REST API overview]
+** link:{{navprefix}}/tutorials/rest-api/lesson-02[Simple Python implementation]
+** link:{{navprefix}}/tutorials/rest-api/lesson-03[Complex REST API workflows]
+** link:{{navprefix}}/tutorials/rest-api/lesson-04[Browser JavaScript REST API implementation]
+
+[.sidebar-title]
+React Components Tutorial
+
+* link:{{navprefix}}/tutorials/react-components/intro[Introduction]
+* link:{{navprefix}}/tutorials/react-components/lesson-01[Initializing ThoughtSpot Embed SDK]
+* link:{{navprefix}}/tutorials/react-components/lesson-02[ThoughtSpot component pages]
+* link:{{navprefix}}/tutorials/react-components/lesson-03[Menus and other navigation elements]
+* link:{{navprefix}}/tutorials/react-components/lesson-04[Event handling]
+//* link:{{navprefix}}/tutorials/spotter/integrate-into-chatbot[Integrate Spotter into your chatbot]

modules/ROOT/pages/common/nav-walkthroughs.adoc

@@ -0,0 +1,50 @@
+
+:page-pageid: nav-walkthroughs
+:page-description: Guided Walkthroughs navigation
+
+//
+// HOW TO ADD A NEW WALKTHROUGH/TUTORIAL GROUP
+// ---------------------------------------------------------------------
+// Each tutorial below MUST be a two-level list:
+//   * Tutorial group name (no link — this line is just the heading)
+//   ** link:...[Step 1]
+//   ** link:...[Step 2]
+//   ...
+//
+// Do NOT flatten this to a single level (all "*", no "**"). The nesting
+// is load-bearing, not cosmetic — the left nav (LeftSidebar/index.scss,
+// ".tutorialsNavWrapper" rules) relies on exactly this two-level shape to:
+//   1. Number each step with a circular badge (counter-reset/increment
+//      on the nested <ul>, restarting at 1 per tutorial).
+//   2. Auto-collapse every OTHER tutorial (and this one's own heading)
+//      once you're inside a tutorial's pages, so only the active
+//      tutorial's numbered steps show (see the ":has()" drill-down rules
+//      in the same file, and LeftSidebar/helper.tsx's expand/collapse
+//      logic, which both require a nested <li> containing a nested <ul>).
+//
+// Flattening this file (even by mistake, e.g. during a merge) silently
+// removes BOTH behaviors with no build error — the nav just renders as
+// a plain unnumbered, ungrouped list of links. If that ever happens,
+// restore the "*" / "**" nesting shown below rather than changing the CSS.
+//
+
+[.sidebar-title]
+Get started
+
+* Build a data-driven app with ThoughtSpot Embedded
+** link:{{navprefix}}/tutorials/embed-data-driven-app/intro[Build a data-driven app with ThoughtSpot Embedded]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/into-developer-portal[Get into the Developer Portal]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/base-liveboard-rendering[Get the base Liveboard rendering]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/make-it-conversational[Make it conversational]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/style-to-match-portal[Style it to match the portal]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/wire-custom-action[Wire in a custom action]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/troubleshooting[When it doesn't just work]
+** link:{{navprefix}}/tutorials/embed-data-driven-app/summary[Where to go from here]
+
+* Build it faster
+** link:{{navprefix}}/tutorials/spottercode-embed/intro[Embed ThoughtSpot with SpotterCode]
+** link:{{navprefix}}/tutorials/spottercode-embed/set-up-spottercode[Set up SpotterCode]
+** link:{{navprefix}}/tutorials/spottercode-embed/embed-liveboard-view[Embed the Liveboard view]
+** link:{{navprefix}}/tutorials/spottercode-embed/embed-spotter[Embed Spotter]
+** link:{{navprefix}}/tutorials/spottercode-embed/troubleshooting[Troubleshooting]
+** link:{{navprefix}}/tutorials/spottercode-embed/summary[Summary]

modules/ROOT/pages/common/nav.adoc

@@ -5,15 +5,18 @@
 [navSection]
 
 [.sidebar-title]
-Release notes and changelogs
+Quickstart Guides
 
-* link:{{navprefix}}/whats-new[What's new]
-* Changelog
-** link:{{navprefix}}/embed-sdk-changelog[Visual Embed SDK changelog]
-** link:{{navprefix}}/mobile-sdk-changelog[Mobile Embed SDK changelog]
-** link:{{navprefix}}/rest-v2-changelog[REST API v2 changelog]
-** link:{{navprefix}}/mcp-server-changelog[Spotter MCP Server changelog]
-* link:{{navprefix}}/deprecated-features[Deprecation announcements]
+* link:{{navprefix}}/tutorials/walkthroughs[Walkthroughs]
+
+[.sidebar-title]
+Get started
+
+* link:{{navprefix}}/getting-started[Embed ThoughtSpot]
+* link:{{navprefix}}/SpotterCode[SpotterCode]
+* link:{{navprefix}}/rest-apis[REST APIs]
+* link:{{navprefix}}/ai-analytics-integration[AI analytics integration]
+* link:{{navprefix}}/mcp-integration[MCP Server integration]
 
 [.sidebar-title]
 Live Playgrounds
@@ -27,69 +30,61 @@ Live Playgrounds
 * +++<a href="https://try-everywhere.thoughtspot.cloud/v2/#/everywhere/playground/theme-builder" target="_blank">Theme Builder</a>+++
 ** link:{{navprefix}}/theme-builder-doc[How to use]
 
-
 [.sidebar-title]
-Get started
+Reference Guides
 
-* link:{{navprefix}}/getting-started[Embed ThoughtSpot]
-* link:{{navprefix}}/SpotterCode[SpotterCode]
-* link:{{navprefix}}/rest-apis[REST APIs]
-* link:{{navprefix}}/ai-analytics-integration[AI analytics integration]
-* link:{{navprefix}}/mcp-integration[MCP Server integration]
-//** link:{{navprefix}}/tutorials/tutorials-overview[Tutorials]
 * link:{{navprefix}}/VisualEmbedSdk[SDK and API reference]
-** link:{{navprefix}}/VisualEmbedSdk[Visual Embed SDK]
-** link:{{navprefix}}/rest-apiv2-reference[REST API]
-** link:{{navprefix}}/mcp-tool-reference[MCP tools]
+* link:{{navprefix}}/rest-apiv2-reference[REST API]
+* link:{{navprefix}}/mcp-tool-reference[MCP tools]
+
+[.sidebar-title]
+Integration Guides
 
+* link:{{navprefix}}/webhooks-overview[Overview]
+** link:{{navprefix}}/webhooks-ui[Webhooks UI]
+** link:{{navprefix}}/webhooks-comm-channel[Webhook communication channels]
+** link:{{navprefix}}/webhooks-lb-schedule[Webhook connection for Liveboard scheduled events]
+** link:{{navprefix}}/webhooks-s3-integration[AWS S3 storage integration for webhook delivery]
+** link:{{navprefix}}/webhooks-gcs-storage[GCS storage integration for webhook delivery]
+** link:{{navprefix}}/webhooks-lb-payload[Webhook response payload]
+** link:{{navprefix}}/webhooks-kpi[Webhook connection for KPI alerts]
+
+* link:{{navprefix}}/external-tool-script-integration[External tools and scripts]
+* link:{{navprefix}}/pendo-integration[Pendo integration with embed]
+* link:{{navprefix}}/sf-integration[Integration with Salesforce]
+* link:{{navprefix}}/vercel-integration[Vercel integration]
 
 [.sidebar-title]
-Build and deploy
+Deployment guides
 
-** link:{{navprefix}}/thoughtspot-objects[ThoughtSpot objects]
-** link:{{navprefix}}/timezone-aware-filtering[Timezone-aware keywords and filters]
-** link:{{navprefix}}/variables[Variables]
-** link:{{navprefix}}/parameterize-metadata[Parameterize metadata]
+* link:{{navprefix}}/thoughtspot-objects[ThoughtSpot objects]
+* link:{{navprefix}}/timezone-aware-filtering[Timezone-aware keywords and filters]
+* link:{{navprefix}}/variables[Variables]
+* link:{{navprefix}}/parameterize-metadata[Parameterize metadata]
 * link:{{navprefix}}/development-and-deployment[Development and deployment]
-** link:{{navprefix}}/deploy-with-tml-apis[Deploy with TML APIs]
-*** link:{{navprefix}}/git-provider-integration[Git provider integration]
-*** link:{{navprefix}}/modify-tml[TML modification]
+* link:{{navprefix}}/deploy-with-tml-apis[Deploy with TML APIs]
+** link:{{navprefix}}/git-provider-integration[Git provider integration]
+** link:{{navprefix}}/modify-tml[TML modification]
 * link:{{navprefix}}/publish-data-overview[Publish content to Orgs]
 ** link:{{navprefix}}/publish-to-orgs[Publish objects to Orgs]
 * link:{{navprefix}}/git-integration[Deploy with GitHub APIs (legacy)]
 ** link:{{navprefix}}/git-configuration[Configure GitHub integration]
 ** link:{{navprefix}}/git-api[GitHub REST APIs]
 ** link:{{navprefix}}/guid-mapping[GUID mapping]
-
-[.sidebar-title]
-Multi-tenancy
-
 * link:{{navprefix}}/multi-tenancy[Overview]
-* link:{{navprefix}}/orgs[Multi-tenancy with Orgs]
+** link:{{navprefix}}/orgs[Multi-tenancy with Orgs]
 ** link:{{navprefix}}/orgs-api-op[Org administration]
 ** link:{{navprefix}}/multitenancy-within-an-org[Multi-tenancy within an Org]
 ** link:{{navprefix}}/single-tenant-data-models[Single-tenant data models with Orgs]
 * link:{{navprefix}}/tse-cluster[Cluster maintenance and upgrade]
 
 [.sidebar-title]
-Webhooks
+Tutorials
 
-* link:{{navprefix}}/webhooks-overview[Overview]
-* link:{{navprefix}}/webhooks-ui[Webhooks UI]
-* link:{{navprefix}}/webhooks-comm-channel[Webhook communication channels]
-* link:{{navprefix}}/webhooks-lb-schedule[Webhook connection for Liveboard scheduled events]
-* link:{{navprefix}}/webhooks-s3-integration[AWS S3 storage integration for webhook delivery]
-* link:{{navprefix}}/webhooks-gcs-storage[GCS storage integration for webhook delivery]
-* link:{{navprefix}}/webhooks-lb-payload[Webhook response payload]
-* link:{{navprefix}}/webhooks-kpi[Webhook connection for KPI alerts]
+* link:{{navprefix}}/tutorials/tutorials-overview[Embedding tutorials]
+* link:{{navprefix}}/tutorials/rest-api/intro[REST API Tutorials]
 
-[.sidebar-title]
-Integration with external tools
 
-** link:{{navprefix}}/external-tool-script-integration[External tools and scripts]
-** link:{{navprefix}}/pendo-integration[Pendo integration with embed]
-** link:{{navprefix}}/sf-integration[Integration with Salesforce]
-** link:{{navprefix}}/vercel-integration[Vercel integration]
 
 [.sidebar-title]
 Additional resources

modules/ROOT/pages/developer-playground.adoc

@@ -136,7 +136,7 @@ To explore the features available for embedding Natural Language Search:
 
 . Go to *Playground* > *Natural Language Search*.
 . Select a data source.
-. +++<a href="{{previewPrefix}}/playground/sage" id="preview-in-playground" target="_blank">Try out</a>+++ the following customization settings and click *Run* to preview the result.
+. +++<a href="{{previewPrefix}}/playground/sage" target="_blank">Try out</a>+++ the following customization settings and click *Run* to preview the result.
 
 [width="100%"]
 |====
@@ -194,7 +194,7 @@ To explore the Spotter embedding features:
 
 . Go to *Playground* > *Spotter*.
 . Select a data source.
-. +++<a href="{{previewPrefix}}/playground/sage" id="preview-in-playground" target="_blank">Try out</a>+++ the following customization settings and click *Run* to preview the result.
+. +++<a href="{{previewPrefix}}/playground/sage" target="_blank">Try out</a>+++ the following customization settings and click *Run* to preview the result.
 
 [width="100%"]
 |====

modules/ROOT/pages/home.adoc

@@ -27,7 +27,6 @@
 [.non-link]
 ++++
 <div class="document-body-wrapper">
-<div class="cardHeading"> Get started with embedding</div>
 <div class="row flex pb-10">
 	<div class="col-md-4 flex">
 <div class="boxDiv"><div>
@@ -117,7 +116,6 @@
 [.non-link]
 ++++
 <div class="document-body-wrapper">
-<div class="cardHeading">Integrate tools and workflows</div>
 <div class="row flex pb-10">
 	<div class="col-md-4 flex">
 <div class="boxDiv"><div>

modules/ROOT/pages/onboarding-guide.adoc

@@ -1,4 +1,4 @@
-= Quickstart Guide
+= Get started with embedding
 :toc: true
 :linkattrs:
 :sectanchors:
@@ -32,7 +32,7 @@ If you’re using the Free Trial instance, note that it is already connected to
 
 To learn more about data connections, data models and objects, and how to search data and create Liveboards, see link:https://docs.thoughtspot.com/cloud/latest/ts-cloud-getting-started[ThoughtSpot product documentation, window=_blank].
 
-== Get started with embedding
+== Embed ThoughtSpotcontent
 This section provides a set of steps to quickly embed a xref:faqs.adoc#lbDef[Liveboard] from the link:https://www.thoughtspot.com/trial?tsiref=web-devsite[Free Trial, window=_blank] or your own ThoughtSpot application instance.
 The following figure shows a sample Liveboard with charts and a table: