## 1. Project Overview & Quickstart (Uniswap/interface)

# Uniswap Labs: Front End Interfaces

This is the **public** repository for Uniswap Labs’ front-end interfaces, including the Web App, Wallet Mobile App, and Wallet Extension. Uniswap is a protocol for decentralized exchange of Ethereum-based assets.

## Interfaces

- Web: [app.uniswap.org](https://app.uniswap.org)
- Wallet (mobile + extension): [wallet.uniswap.org](https://wallet.uniswap.org)

## Install & Apps

```bash
git clone git@github.com:Uniswap/interface.git
bun install
bun web start
```

For instructions per application or package, see the README published for each application:

- [Web](apps/web/README.md)
- [Mobile](apps/mobile/README.md)
- [Extension](apps/extension/README.md)

## Contributing

For instructions on the best way to contribute, please review our [Contributing guide](CONTRIBUTING.md)!

## Socials / Contact

- X (Formerly Twitter): [@Uniswap](https://x.com/Uniswap)
- Reddit: [/r/Uniswap](https://www.reddit.com/r/Uniswap/)
- Email: [contact@uniswap.org](mailto:contact@uniswap.org)
- Discord: [Uniswap](https://discord.com/invite/uniswap)
- LinkedIn: [Uniswap Labs](https://www.linkedin.com/company/uniswaporg)

## Uniswap Links

- Website: [uniswap.org](https://uniswap.org/)
- Docs: [uniswap.org/docs/](https://docs.uniswap.org/)

## Whitepapers

- [V4](https://uniswap.org/whitepaper-v4.pdf)
- [V3](https://uniswap.org/whitepaper-v3.pdf)
- [V2](https://uniswap.org/whitepaper.pdf)
- [V1](https://hackmd.io/C-DvwDSfSxuh-Gd4WKE_ig)

## Production & Release Process

Uniswap Labs develops all front-end interfaces in a private repository.
At the end of each development cycle:

1. We publish the latest production-ready code to this public repository.

2. Releases are automatically tagged — view them in the [Releases tab](https://github.com/Uniswap/interface/releases).

## 🗂 Directory Structure

| Folder      | Contents                                                                       |
| ----------- | ------------------------------------------------------------------------------ |
| `apps/`     | The home for each standalone application.                                      |
| `config/`   | Shared infrastructure packages and configurations.                             |
| `packages/` | Shared code packages covering UI, shared functionality, and shared utilities.  |

## 2. Official Technical Reference & Guides (Uniswap/docs)

# Uniswap Developer Docs

Source content for the Uniswap developer documentation published at [developers.uniswap.org](https://developers.uniswap.org).

All documentation lives in the [`content/`](content) directory. Content changes (fixes, new pages, examples) belong there. The [`archive/`](archive) directory holds the previous version of this repository, kept for reference only.

## Repository structure

```
├── content/                            # developers.uniswap.org content
│   ├── get-started/                    # Core concepts and quickstart
│   ├── trading/                        # Trading integrations, Swapping API
│   ├── liquidity/                      # UniswapX, Liquidity Launchpad, Provisioning API
│   ├── protocols/                      # v2, v3, v4, Universal Router, Permit2,
│   │                                   #   smart wallet, The Compact, protocol fee
│   ├── sdks/                           # SDK documentation (v2, v3, v4)
│   ├── uniswap-ai/                     # Uniswap AI skills and plugins
│   ├── unichain/                       # Unichain: getting started, guides, tooling
│   ├── ecosystem/                      # Governance, subgraphs, builder support
│   ├── community/                      # Community tooling and learning resources
│   ├── changelog/                      # API and protocol change notifications
│   ├── examples/                       # Example contracts and SDK snippets
│   └── meta.json                       # Root navigation configuration
├── archive/                            # Previous version of this repository (reference only)
├── CONTRIBUTING.md
├── DISCLAIMER.md
├── LICENSE
└── README.md
```

## Contributing

Contributions are welcome, and our team reviews every PR. Content changes go inside `content/`. See the [contribution guidelines](CONTRIBUTING.md) for how the process works and how to get started.

## Content conventions

Each `.mdx` file starts with frontmatter:

```yaml
---
title: "Page Title"
---
```

`meta.json` files control sidebar navigation per section:

```json
{
  "title": "Section Title",
  "pages": ["page-slug", "another-page"]
}
```

- Page slugs reference file names without the `.mdx` extension
- Use `---Section Name---` entries for sidebar separators
- Order in the array determines sidebar order

## License

Content and code in this repository are licensed under the [MIT license](LICENSE). See also the [disclaimer](DISCLAIMER.md).