Phase 5 - Running & Debugging

Plain-language guide to the Sync Engine: declared vs observed, the four states, when it acts, and the blind spot behind install failures.

The Sync Engine

How to read the Visualizer graph, what every button does, and what it cannot tell you.

Using the Sync Engine Visualizer

First-line triage for app install and run failures: the grant chain, symptom-to-owner table, and how to file an issue.

Troubleshooting App Installs & Runs

Current known issues affecting app installs and runs, and how to report problems so they get triaged fast.

Known Issues & How to Report a Problem

Get an overview of Insight Cloud features and how to use them.

Provide Feedback

Latest Changes

What's Planned

Getting Started

Welcome to Insight Cloud. Your new destination for analytics. 

Start Guide

Foundational ideas behind Insight Cloud and the terms used across the platform.

Concepts

Your personalized starting point in Insight Cloud.

Home

My Apps

Apps are the core analytics experiences inside Insight Cloud.

App Basics

Run the same app with different parameters by market, brand, or use case without switching apps.

App Variants

How to read when your app's data and analysis were last updated.

Data Freshness

Explore Mode helps you take your apps and insights even further

Explore Mode

Shared Views 

Intelligence

Get answers, analysis, and guidance across every app in your workspace.

Where to find Seek's policies for data handling and AI safety.

Data Privacy & AI Safety

External dashboards and tools for your workflow

My Reports

Access and organize links to reports from external analytics tools in one central place

Browse and inspect the datasets powering your apps.

Data

Browse and inspect the datasets that power your apps.

Help documentation for creator flows in Insight Cloud.

Create

Phase 1 - The Big Picture

What SBT is, the key terms (Beta vs 1.0, package vs app), and the build-to-publish workflow at a glance.

Seek Build Tools (SBT) Overview

The full journey of an Insight Cloud app: from SBT build, to install, to a running dashboard.

App & Data Lifecycle

What build and publish each do, where version numbers come from, and how orgs get upgraded.

App Publishing Lifecycle

Phase 2 - Get Set Up

Install SBT step by step on any OS and verify it works. One-time setup per computer.

Setting Up SBT

Reference for the sbtconf.toml project config file: what's in it, how to add environments, how to switch between them, and how to keep it safe.

Configuring Your Project (sbtconf.toml)

Build and run your first complete app with SBT: three tiny tables, two models, one app. Every step verified on SBT 1.0.10.

Quickstart

Every sbt command with a real example, the argument shapes, and the gotchas the --help text doesn't tell you.

SBT Command References

Phase 3 - Building Blocks (in dependency order)

The app yaml reference: bundling models into an app, required fields, and SBT 1.0 additions.

Apps

Declaring the tables your app reads in sources yaml, bundled vs non-bundled, and changing mappings after install.

Sources

Define schemas to validate your sources and model outputs: columns, constraints, and the validate commands.

Schemas

A model consists of code that populates a single table or view, along with metadata properties that define how your users can interact with the model.

Models

How freshness settings and shared models reduce redundant app runs and compute costs.

Model Reuse: Freshness and Shared Models

Reusable helper queries and the run context (the seek object) your model code receives at runtime.

Helpers & the Run Context

The three ways an app gets its Python dependencies — the packages key, wheel files in modules/, and requirements.txt — and which one applies to your app.

Dependencies: packages, wheels, and requirements.txt

Restrict which rows of data an organization can see using RLS parameters: how to define them in SBT, what subscribers see at install, and how to write model code that filters correctly.

RLS Parameters (Row-Level Security)

Phase 4 - Publishing & Installing

The one-time Snowflake grants a publisher runs so apps can read their source tables — the complete script, why each grant exists, and how to know it worked.

Publisher Snowflake Setup (Grants)

What must be in place in Snowflake and your SBT project before an app can install and run successfully.

Prerequisites for App Installs

The admin-side install walkthrough: grant access, install, Set Data Access, source mappings, first run, and how to confirm it actually worked.

Installing an App into an Organization

App Context is the semantic model that lets the Intelligence tool understand an app's data output, so it can answer questions and write accurate SQL.

App Context

Phase 6 - Reference

Wire a Sigma dashboard to your app: user attributes, the data model SQL pattern, and the embed flow.

Data Visualizations with Sigma

How to migrate a Beta app to SBT 1.0: command changes, the checklist, and what upgrades preserve.

SBT 1.0 App Migration Guide

What changed in each SBT release, and what it means for app builders.

SBT Changelog

Publisher tools for making your apps discoverable: your public profile (required for the App Store), your catalog of app listings, and a view of the warehouses your apps use.

Publish

Publisher Profile

Discover, subscribe to, and manage apps from the App Store.

App Store

Browse and subscribe to apps on Insight Cloud.

App Store Basics

Subscribe to apps from the App Store to view in your workspace.

Subscriptions

Load your wallet to get access to apps you need

Wallet

Account

Login Methods

Manage your personal profile, password, and preferences in Insight Cloud.

Personal Settings

API Keys

Notification Center

Settings for administering your organization in Insight Cloud.

Organization Settings

Manage your organization’s users, teams, roles, and apps.

Org Management

What lives in Administration and how to manage your workspace.

Administration overview

Manage who has access to your Insight Cloud workspace

Users

Teams help you organize users and apps at scale

Teams

Define what users can see and do in Insight Cloud

Roles

Tools for managing how your organization pays for and accesses apps in Insight Cloud.

For admins — manage workspace Wallet funds, purchasing permissions, and spend visibility.