Getting Started

Get up and running with Wallabi.

This guide walks you through setting up your local environment so you can start building data apps. It takes about 10 minutes.

On Windows, set up your environment first — see Getting Started on Windows.

Prefer not to install the toolchain locally? Set up Codespaces instead.

Make sure you’ve completed the Prerequisites first.

Get Your App Host Repository

An app host is the project that contains your data apps — think of it as your team’s workspace. Your Wallabi contact will create one for you and share a repository URL. You can also find it in the Wallabi app under your app host’s settings — look for the Git URL. If you don’t have an app host yet, reach out to your Wallabi contact.

Open a terminal and clone it into a folder where you keep projects (e.g., your home directory or a projects folder):

cd ~/projects
git clone https://github.com/wallabidata/app-host-acme-corp.git
cd app-host-acme-corp

Replace wallabidata/app-host-acme-corp with the actual repository name from your Git URL. If you’re new to Git, this downloads a copy of your team’s project to your computer.

On Windows with WSL2, run this in your WSL terminal and clone into your WSL home directory — never under /mnt/c/, where installs and file watching are much slower.

Set Up the Project

These steps are the same wherever your environment lives — on your own machine or in a Codespace. Run them from a terminal in the app host folder.

  1. Run the setup script. This will prompt you for your Wallabi API token (from Prerequisites):

    pnpm run setup

    Follow the prompts to enter your token and slug. This creates your personal development environment and saves your configuration locally.

  2. Install dependencies:

    pnpm install

  3. Start the dev server:

    pnpm run dev

  4. Open your apps. Go to your app hosts in the Wallabi app and click on your app host. You’ll see a list of your data apps — click any app name to open it. You can also find app URLs in the dev server’s terminal output, but the Wallabi app is the easiest way to navigate to them.

  5. Start your AI assistant. Open a second terminal window in the same folder and run:

    claude

    This launches Claude Code, an AI assistant that connects to your dev server and your data. You can ask it to build new apps, modify existing ones, or explore your data — all in plain language. Try asking it to change something and watch the app reload.

Checking That Everything Works

After starting the dev server, you should see:

  • No error messages about missing configuration in the terminal
  • Your apps listed in the Wallabi app under your app host
  • Apps displaying data when you open them in your browser

After starting Claude Code, try asking:

  • “What data sources are available?”
  • “Describe the tables in [your data source name]”

If it can answer these questions, you’re all set.

If something isn’t working, see the Troubleshooting page.

Next Steps