Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/grafbase/pathfinder

The missing GraphQL IDE
https://github.com/grafbase/pathfinder

app component graphql ide react tauri

Last synced: 3 months ago
JSON representation

The missing GraphQL IDE

Awesome Lists containing this project

README

        


Pathfinder

Pathfinder


The missing GraphQL IDE


Free, open-source and cross-platform


The Pathfinder desktop application

# Installation & Usage

```bash
pnpm add @pathfinder-ide/react # or yarn add @pathfinder-ide/react or npm install @pathfinder-ide/react
```

The sole export from `@pathfinder-ide/react` is a React component called Pathfinder. For our initial release, a limited set of props is allowed. You can see examples of props usage in the `pathfinder.stories.tsx` file.

# Local development

## Clone the repository

```bash
git clone https://github.com/grafbase/pathfinder.git
```

## Install packages

```bash
cd pathfinder
pnpm i
```

## Update .env

The primary development environment for Pathfinder is [ladle](https://ladle.dev/) and the Pathfinder stories are set up to use environment variables. Make a copy of the example file:

```bash
cd apps/ladle
cp .env.development.local.example .env.development.local
```

Once copied, you can open `.env.development.local` and add an endpoint, at a minimum, and auth header key/value if necessary.

## Build monaco workers

Building the necessary workers ahead of time absolves consuming code from having to fuss with build tool plugins. This is good.

```bash
pnpm react:build:workers
```

## Run ladle

```bash
pnpm ladle:serve
```

Ladle is at `http://localhost:61000/`.