> ## Documentation Index
> Fetch the complete documentation index at: https://docs.travelese.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Local Development

> A guide on how to run Travelese's codebase locally.

###

## Introduction

Travelese's codebase is set up in a monorepo via [Turborepo](https://turbo.build/repo) and is fully [open-source on GitHub](https://git.new/travelese).

Here's the monorepo structure:

```
apps
├── api
├── dashboard
├── docs
├── engine
├── mobile
├── website
packages
├── documents
├── email
├── events
├── import
├── inbox
├── jobs
├── kv
├── location
├── notification
├── supabase
├── tsconfig
├── ui
├── utils
```

The `apps` directory contains the code for:

* `api`: The backend for Travelese (supabase).
* `dashboard`: Travelese's application ([app.travelese.ai](https://app.travelese.ai)).
* `docs`: Travelese's documentation site ([travelese.ai/docs](https://travelese.ai/docs)).
* `engine`: Travelese's bank engine ([travelese.ai/engine](https://travelese.ai/engine)).
* `mobile`: Travelese's mobile app.
* `website`: Travelese's website app ([travelese.ai](https://travelese.ai)).

The `packages` directory contains the code for:

* `documents`: OCR for receipts.
* `events`: Analytics library.
* `import`: CSV-importer.
* `inbox`: Inbox utils.
* `jobs`: Background jobs.
* `kv`: Key value storage client.
* `location`: Location related utils.
* `notification`: Notifications client.
* `supabase`: Queries and client.
* `tsconfig`: The TypeScript configuration for Travelese's web app.
* `ui`: UI component library.
* `utils`: A collection of utility functions and constants used across Travelese's codebase.

## Running Travelese locally

To run Travelese locally, you'll need to set up the following:

* A [Supabase](https://supabase.com/) account
* An [Upstash](https://upstash.com/) account

## Step 1: Local setup

First, you'll need to clone the Travelese repo and install the dependencies.

**1. Clone the repo**

First, clone the [travelese.ai repo](https://d.to/github) into a public GitHub repository.

```bash Terminal
git clone https://github.com/travelese-ai/travelese.git
```

**2. Install dependencies**

Run the following command to install the dependencies:

```bash Terminal
bun i
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.