# Contribute

Set up a Paradev (formerly Superset) open-source contribution, from forking and cloning...

- Repository: https://github.com/ParadevAI/Paradev (15823 stars)
- Category: Git and review
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ParadevAI/Paradev --skill contribute -g -a claude-code -y`
Codex: `npx skills add ParadevAI/Paradev --skill contribute -g -a codex -y`
Cursor: `npx skills add ParadevAI/Paradev --skill contribute -g -a cursor -y`
Gemini CLI: `npx skills add ParadevAI/Paradev --skill contribute -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ParadevAI/Paradev`

## Description

Set up a Paradev (formerly Superset) open-source contribution, from forking and cloning paradevai/paradev through local dev setup and the repo's rules to a merge-ready PR. Use when the user wants to contribute to Paradev, fix a Paradev bug themselves, add a feature to Paradev, or prepare a PR against paradevai/paradev.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Contribute to Paradev

Take the user from "I want to fix/build X in Paradev" to a merge-ready PR that follows the repo's rules. If the checked-out repo has `CONTRIBUTING.md`, `DEVELOPMENT.md`, or `AGENTS.md`, those files are authoritative; read them and prefer them over this summary.

## 1. Scope first

- Bug fixes, docs, small improvements: straight to a PR, no issue needed
- New features or larger changes: open an issue first at https://github.com/paradevai/paradev/issues/new/choose to agree on the approach before building
- Questions: Paradev Discord, not an issue

## 2. Set up

1. `gh auth status`, then fork and clone: `gh repo fork paradevai/paradev --clone` (or add a fork remote to an existing clone)
2. Best experience: add the clone as a project in the Paradev app and create a workspace per change, so contributions develop inside managed worktrees
3. In the new workspace/worktree, run `./.superset/setup.local.sh` once (configures per-workspace ports, app identity, local services, and a seeded dev account; no external credentials needed), then `bun run dev`
4. Bun only, never npm/yarn/pnpm. Read the root `AGENTS.md` and follow it.

## 3. Make it merge-ready

- Branch from `main`; one change per PR, so unrelated finds become a second PR
- Before pushing: `bun run lint:fix`, then verify `bun run lint` exits clean (CI fails on warnings too), `bun run typecheck`, `bun run test`
- PR title must be a conventional commit (`feat(desktop): ...`, `fix(web): ...`); PRs are squash-merged with the title as the commit subject
- Include proof it works: screenshots or recordings for anything user-visible, before/after for fixes. The dev desktop app exposes CDP for clean captures; see "Capturing screenshots via CDP" in CONTRIBUTING.md
- Check "Allow edits from maintainers" and link the issue for non-trivial changes

## 4. Open it

The rest: https://github.com/ParadevAI/Paradev/blob/HEAD/plugins/superset/skills/contribute/SKILL.md