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

# Contributing

> Report an issue or prepare a focused contribution to Presenton.

Presenton is open source under the Apache 2.0 license. Before writing code, check the repository's current contribution scope: contributions outside `electron/` may not be accepted at this time.

<CardGroup cols={2}>
  <Card title="Report a bug" icon="bug" href="https://github.com/presenton/presenton/issues">
    Include reproduction steps, expected and actual behavior, and useful logs or screenshots.
  </Card>

  <Card title="Discuss a feature" icon="comments" href="https://github.com/presenton/presenton/discussions">
    Explain the user problem and the result you want before proposing implementation details.
  </Card>
</CardGroup>

## Current code contribution scope

The accepted scope centers on the Electron application, including its desktop application, FastAPI backend, Next.js frontend, and local runtime integrations.

```text theme={null}
presenton/
└── electron/        # Current contribution scope
    ├── desktop app
    ├── backend
    ├── frontend
    └── local runtime integrations
```

<Warning>
  Confirm the current scope in the canonical [CONTRIBUTING.md](https://github.com/presenton/presenton/blob/main/CONTRIBUTING.md) before starting. Repository policy can change independently of this documentation snapshot.
</Warning>

## Prepare the development environment

You need Node.js LTS, npm, Python, and the `uv` Python package manager.

```bash theme={null}
cd electron
npm run setup:env
npm run dev
```

The setup command installs the Electron, FastAPI, and Next.js dependencies. `npm run dev` compiles TypeScript and starts the local backend and UI with the desktop application.

## Before opening a pull request

* Keep the change inside `electron/`, small, and focused.
* Verify both the development workflow and the relevant build workflow.
* Explain the problem, the change, and how you tested it.
* Include before-and-after screenshots for UI changes.
* Sign the Contributor License Agreement when prompted.
* Follow the repository Code of Conduct.

<Note>
  Pull requests left without a signed CLA for more than 30 days may be closed under the repository's contribution policy.
</Note>

## AI-assisted contributions

AI-assisted pull requests are welcome. State that AI tools were used, describe the testing performed, and confirm that you reviewed the generated code yourself.

<Card title="Read the canonical contribution guide" icon="github" href="https://github.com/presenton/presenton/blob/main/CONTRIBUTING.md">
  Check the live scope, setup steps, CLA policy, and community links before contributing.
</Card>