Skip to main content
Apps are the core building block of Telemetry. Each app is a self-contained application that connects to your database and displays data through components.

​
What is an app?

An app consists of:
  • Components — UI elements like tables, inputs, and selects arranged on a canvas
  • Queries — SQL statements that fetch data from your database
  • State — Runtime data from user inputs and query results

​
Creating an app

  1. Navigate to the Apps page
  2. Click “New App”
  3. Enter a name for your app
  4. Start building by adding components and queries

​
App structure

Each app has:
PropertyDescription
NameDisplay name for the app
SlugURL-friendly identifier (auto-generated from name)

​
Building your app

Once you’ve created an app, you can:
  1. Add components — Drag and drop from the component palette onto the canvas
  2. Create queries — Write SQL to fetch data from your connected database
  3. Configure components — Set up each component using basic mode or code mode
  4. Connect data — Use transforms to display query data in your components

​
Example workflow

  1. Create a new app called “User Dashboard”
  2. Add a Connection to your database
  3. Create a Query to fetch users: SELECT * FROM users LIMIT 100
  4. Add a Table component to the canvas
  5. Write a transform to display the query results
  6. Add an Input for search and a Select for filtering
  7. Update the table transform to filter based on user input
See the Components page for details on available components and the State page for how data flows through your app.