---
title: "Introduction"
description: "What Skiffr is made of and where to find things."
url: https://docs.skiffr.findmalek.engineer/docs
markdown: https://docs.skiffr.findmalek.engineer/docs/index.md
---

# Introduction

skiffr is an open-source Chrome extension that fills job applications from your own profile, and never submits anything for you. A dashboard keeps your profile, answers, a job queue and stats. You host the api and the database yourself. It is in early development and not released: the extension detects forms, asks, fills them and learns from your edits today, with the limits listed in [how skiffr learns](https://docs.skiffr.findmalek.engineer/docs/learning.md).

The repo is a turborepo with a landing page, a dashboard with login, an api, and the extension, wired to postgres with pgvector, auth and typed rpc. Edit these pages in `apps/docs/content/docs`, they are plain mdx.

## What is in the repo

- `apps/web`: the landing page. It only talks to the api
- `apps/dashboard`: profile, answers, queue, stats, Gmail, sources and tokens. It only talks to the api
- `apps/api`: orpc on bun. The only app that touches the database, auth and providers
- `apps/extension`: the Chrome extension (WXT, React, Manifest V3). It calls the api with a token
- `apps/e2e`: the Playwright suite that drives the built extension
- `apps/docs`: this site
- `packages/*`: shared code, see [structure](https://docs.skiffr.findmalek.engineer/docs/structure.md)

## Where to go next

- [Setup](https://docs.skiffr.findmalek.engineer/docs/setup.md): Install, start postgres, run the apps.

- [Environment](https://docs.skiffr.findmalek.engineer/docs/environment.md): Every key in the root `.env`.

- [Structure](https://docs.skiffr.findmalek.engineer/docs/structure.md): Apps, packages and the rules between them.

- [The extension](https://docs.skiffr.findmalek.engineer/docs/extension.md): Install it, connect it, what it does on a page.

- [The dashboard](https://docs.skiffr.findmalek.engineer/docs/dashboard.md): Answers, queue and stats.

- [Gmail job emails](https://docs.skiffr.findmalek.engineer/docs/gmail.md): Turn job alerts into queued jobs.

- [Job sources](https://docs.skiffr.findmalek.engineer/docs/sources.md): Watch careers pages and feeds.

- [Deploy](https://docs.skiffr.findmalek.engineer/docs/deploy.md): Vercel, Docker or Dokploy.

- [How skiffr learns](https://docs.skiffr.findmalek.engineer/docs/learning.md): Lookup order, what is learned, what never is.

- [Privacy and data flow](https://docs.skiffr.findmalek.engineer/docs/privacy.md): Exactly what leaves your machine.