Quick Start Guide

Get up and running with Lucaro in under 10 minutes. This guide walks you through creating your first project, connecting data, and building a dashboard.

Prerequisites

  • A Lucaro account (sign up at lucaro.dev)
  • Access to a data warehouse or database (PostgreSQL, Snowflake, BigQuery, etc.)
  • Database credentials with read access
1

Create Your Account

Sign up for a free Lucaro account to get started.

Visit lucaro.dev and click "Start Free Trial". Enter your email, create a password, and verify your email address. Your 14-day free trial begins immediately with full access to all features.

2

Create Your First Project

Projects organize your data sources, dashboards, and team members.

After signing in, click "New Project" from your dashboard. Give your project a name and description. Projects help you organize related data sources and dashboards together.

3

Connect a Data Source

Connect to your data warehouse or database.

Navigate to your project and click "Add Data Source". Select your database type (PostgreSQL, Snowflake, BigQuery, etc.) and enter your connection credentials. Lucaro will test the connection and scan your schema.

-- Example: Lucaro will discover tables like
SELECT table_name FROM information_schema.tables
WHERE table_schema = 'public';
4

Define Your First Metric

Create a metric in your registry for consistent analytics.

Go to the Metrics Registry and click "New Metric". Define your metric with a name, description, and SQL expression. Metrics ensure everyone uses the same definitions across all dashboards.

-- Example metric definition
name: monthly_revenue
description: Total revenue for the current month
expression: SUM(amount) WHERE date >= DATE_TRUNC('month', CURRENT_DATE)
5

Create Your First Dashboard

Build a dashboard using your metrics and data.

Click "New Dashboard" and use the drag-and-drop builder to add visualizations. Select metrics from your registry or write custom queries. Lucaro automatically suggests the best chart types for your data.

6

Invite Your Team

Collaborate with your team members.

Go to Project Settings and click "Invite Members". Enter email addresses and assign roles (Viewer, Editor, Admin). Team members will receive an invitation email to join your project.