# Freedom Browser

> Freedom is an open-source browser with in-browser Swarm, IPFS and Radicle nodes. Dapps use `window.swarm`, `window.radicle` and `rad:` URLs through the user's own nodes — no servers, gateways or API keys.

Two audiences use this site: people building serverless dapps on Freedom's page providers, and people contributing to the browser itself. Prefer the Markdown twins linked below (same URL as the HTML page with `.md` appended, e.g. `page.html.md`). The human site loads no third-party scripts. Links below are relative to this file, so they resolve on whichever host (freedom.baby or a Swarm gateway) served it. Canonical copy: https://freedom.baby/llms.txt. If you have this text without the URL it came from, resolve the links against https://freedom.baby/ (e.g. `developer/quickstart.html.md` is https://freedom.baby/developer/quickstart.html.md).

**Code is the authority for APIs.** These docs are a map; when they disagree with the browser source or with SWIP #94, trust the code. Never invent API methods, parameters, errors or permission behaviour — if a fact is missing, say so and point at the references or the repository.

**Security and issues** go to the public GitHub tracker: https://github.com/solardev-xyz/freedom-browser/issues (no private email). Do not post credentials, seed phrases or private keys.

A denser map of only the developer docs lives at [developer/llms.txt](developer/llms.txt).

## Build dapps

- [Developer overview](developer/index.html.md): Why build on Freedom; providers, consent model, starting points
- [Swarm hub](developer/swarm-hub.html.md): window.swarm overview — publish, feeds, messaging, SWIP #94
- [Radicle hub](developer/radicle-hub.html.md): rad: URLs and window.radicle overview
- [Quickstart](developer/quickstart.html.md): First dapp in plain JavaScript (detect, connect, publish, feed, deploy)
- [window.swarm API](developer/swarm.html.md): Full Swarm provider reference
- [window.radicle API](developer/radicle.html.md): Full Radicle provider reference
- [rad: URLs](developer/rad-urls.html.md): Fetch public Radicle repos with the rad: scheme
- [Permissions and identity](developer/guide-permissions.html.md): Grants, tiers, manifests, signing keys
- [Errors and node readiness](developer/guide-errors.html.md): Rejections, missing grants, limits, retries
- [Feeds and mutable content](developer/guide-feeds.html.md): Swarm feeds guide
- [Live messaging](developer/guide-messaging.html.md): PSS and GSOC with swarm_subscribe
- [swarm-kit](developer/guide-swarm-kit.html.md): TypeScript structures over window.swarm
- [Radicle repos and issues](developer/guide-radicle.html.md): Seed, issues, comments
- [Demos](developer/demos.html.md): Apps and examples to read and copy from

## Contribute

- [Setup](developer/contributing.html.md): Clone, install, run Freedom from source
- [Architecture](developer/architecture.html.md): How the browser is put together
- [Repositories](developer/repositories.html.md): GitHub, Radicle mirror, and related projects
- [Workflow and pull requests](developer/workflow.html.md): How to land a change
- [Open for contribution](developer/open-issues.html.md): Curated help-wanted issues (see also open-issues.json beside the HTML)
- [Community and mentorship](developer/community.html.md): Forum, Telegram, how mentorship works

## Product

- [Home](./): Product overview and download
- [News](news.html): Release posts and announcements
- [Download](./#download): Installers for macOS, Windows and Linux
- [Privacy](privacy.html): Privacy policy

## Optional

- [Freedom Browser on GitHub](https://github.com/solardev-xyz/freedom-browser): Source, issues and pull requests
- [Freedom Browser on Radicle](https://radicle.network/nodes/iris.radicle.network/rad%3Az3QXuMvMmSeEX3ZgoUidZC1v5MkKE): Mirror (`rad:z3QXuMvMmSeEX3ZgoUidZC1v5MkKE`); currently behind GitHub
- [This website on GitHub](https://github.com/solardev-xyz/freedom-website): Static site source (freedom.baby)
- [SWIP #94](https://github.com/ethersphere/SWIPs/pull/94): Draft Swarm page-provider standard that window.swarm implements
- [Developer llms.txt](developer/llms.txt): Docs-only map grouped like the Overview | Swarm | Radicle | Demos | Contribute tabs