Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

You can run Uniswap Labs’ current browser interface locally from its official Uniswap/interface repository with Bun and the Node.js version specified in .nvmrc. The documented command is bun web dev, which starts the development server on port 3000 by default. The current web setup instructions explain local startup, but do not document how to configure the app for a testnet or confirm support for a particular network.

What this setup does—and does not do

The current Uniswap interface repository is a monorepo containing more than the browser app. For local browser development, follow the instructions for apps/web, not instructions for the mobile wallet, extension, or an older interface. The repository-level overview is at Uniswap/interface; the web-specific steps are in its apps/web README.

Starting the web app locally and connecting it to a testnet are separate tasks. The current web README documents how to run the development server, but does not specify a testnet selection procedure, required configuration values, or the contracts and services needed for a testnet connection. Consequently, these instructions can get the current web frontend running on your computer, but they do not establish that it will connect to Sepolia or another testnet.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Run the current Uniswap web app locally

  1. Clone the official repository. Its root quick start gives git clone git@github.com:Uniswap/interface.git. This SSH form requires GitHub SSH access to be configured. The repository is also available at github.com/Uniswap/interface.

    #1 Best Overall
    Sale
    Ledger Nano X - Classic Crypto Wallet with Bluetooth
    • Effortlessly build your crypto portfolio via the all in one Ledger Wallet app: buy, sell, send, receive, swap, stake and more across popular blockchains. 15,000+ coins & tokens in a single dashboard. Keep a close eye on the market. Compare service providers. Track performance. Get timely alerts. Build your portfolio with confidence.
    • Effortlessly build your crypto portfolio via the all in one Ledger Wallet app: buy, sell, send, receive, swap, stake and more across popular blockchains. 15,000+ coins & tokens in a single dashboard. Keep a close eye on the market. Compare service providers. Track performance. Get timely alerts. Build your portfolio with confidence.
    • Enjoy Bluetooth connectivity, iOS access, and hours of battery use with this mobile-first, secure backup signer. Freedom you can depend on.
    • Genuine Check: confirm your signer is authentic during setup with the Ledger Wallet app.
    • Protect your signer: keep it in mint condition at all times with a bespoke Pod or Case to avoid scratches and everyday wear and tear.
  2. Use the Node.js version pinned by the repository’s .nvmrc. With nvm installed, run nvm use from the repository directory. Check the current file rather than relying on a version number copied from an older guide.

  3. Install dependencies with Bun: bun install.

  4. Start the web development server with bun web dev. The web README says it defaults to port 3000.

    Rank #2
    TANGEM Crypto Wallet Pack of 2 – Trusted Cold Storage Hardware Wallet
    • Proven security at scale: Over 9 years and millions of cards issued with no known remote hacks, while military‑grade EAL6+ security keeps your private keys locked inside the chip. Your cryptocurrencies stay strongly protected from online attackers.
    • Tap once to manage your entire crypto wallet across 90 blockchains - no USB cables or Bluetooth, no batteries, no setup. Access 14,100+ coins & tokens, DeFi, NFTs, and staking instantly from your phone
    • Smart backup: Use your second Tangem Wallet as your Backup keys with end‑to‑end encryption; no more papers, pictures. If one card is lost, the remaining can still restore full access, with an optional seed phrase available for advanced users.
    • Engineered to last up to 25 years: Waterproof (IP69K), shockproof and tested for extreme temperatures from −25°C to 50°C. A durable cold wallet with long‑term protection and independently audited security.
    • Trusted by 6 million users worldwide - buy, sell, swap, stake, and spend cryptocurrency directly. The secure offline storage wallet designed for how people actually use crypto wallets

The repository root also lists bun web start in its quick start, but for the web app’s documented development-server workflow, use the web README’s bun web dev command. The web README describes a Vite-based setup with experimental Rolldown support; that implementation detail does not change the documented local-development command.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Keep the default port unless you have a reason to change it

The web README warns that using a port other than 3000 may cause CORS errors with certain Uniswap Backend services. If the app fails to reach a backend after you change the port, return to the default before troubleshooting other settings. The README does not provide a testnet-specific port configuration or a workaround that would make a different port appropriate for every backend service.

Rank #3
Trezor Safe 3 Crypto Hardware Wallet with Secure Element
  • Unparalleled Security: Protect your assets with EAL 6+ Secure Element, offering robust defense and complete transparency
  • Simple & Secure Interface: Manage your digital assets easily with a clear OLED screen for secure on-device confirmations
  • Supports 1000s of Coins & Tokens: Securely handle thousands of assets, including Bitcoin, Ethereum, and more, all in one wallet
  • Effortless Asset Management: Monitor and transact seamlessly with Trezor Suite, our intuitive desktop and mobile app
  • Enhanced Backup Solution: Multi-share Backup eliminates single points of failure for secure cold wallet recovery

Testnet configuration is not documented in the current web setup

The current web README does not say which testnets the app supports or how to select one for local development. It also does not document environment variables for a testnet RPC endpoint or chain ID. A mention of chain or testnet concepts in the repository’s package manifest is not, by itself, a user-facing configuration guide.

Do not add REACT_APP_CHAIN_ID or REACT_APP_NETWORK_URL to the current app on the assumption that they configure it. Those variables appear in the README for the separate legacy Uniswap V1 interface. That older guide is relevant only if you are deliberately working with that V1 codebase; it does not establish that the same variables work in today’s apps/web.

Rank #4
Trezor Safe 5 Crypto Hardware Wallet with Color Touchscreen
  • UNPARALLELED SECURITY: Protect your assets with Trezor Safe 5's NDA-free EAL 6+ Secure Element, offering robust defense and complete transparency.
  • EFFORTLESS NAVIGATION: Experience seamless crypto management with the vibrant color touchscreen, designed for intuitive and user-friendly interactions.
  • ENHANCED USER EXPERIENCE: Enjoy tactile confirmation with Trezor Touch Haptic Engine, making each interaction precise and engaging.
  • SUPPORTS 1000s OF COINS & TOKENS: Securely handle thousands of assets, including Bitcoin, Ethereum, and more, all in one wallet.
  • EASY ASSET MANAGEMENT: Monitor and transact seamlessly with Trezor Suite, our user-friendly desktop and mobile app

If your goal specifically requires Sepolia or another testnet, first verify the current app’s network and configuration guidance in the official web repository for the revision you are running. Without that guidance, the supported network and connection procedure are not established here; do not treat a successful local server start as proof of testnet connectivity.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Local browser settings are separate by origin

The official Uniswap interface releases page says the interface stores settings such as imported tokens in browser localStorage. Settings are not shared across different URLs, so a local development address, the hosted app, and an IPFS gateway can have separate saved settings. The releases page recommends an IPFS gateway that enforces origin separation or using the hosted app.

Best Value
Ledger Nano S Plus - Classic Crypto Wallet
  • All your digital assets in one place. You can manage thousands of crypto including Bitcoin, Ethereum, Solana, Tether and more.
  • Defend your identity against hackers: secure your online accounts with passwordless, hardware backed, 2FA logins for all your favorite apps and websites.
  • Connectivity: USB-C cable connection only. No Bluetooth.Compatible with the Ledger Wallet crypto app, both desktop (Windows, macOS, Linux) and mobile (Android only). Not compatible with iOS.
  • Protect your digital assets with the industry's best security: keep your private keys offline in your private signer, battle-tested by the Donjon's white hat hackers, CC EAL 6+ certified Secure Element, constantly updated Ledger OS.
  • Effortlessly build your crypto portfolio via the all in one Ledger Wallet app: buy, sell, send, receive, swap, stake and more across popular blockchains. 15,000+ coins & tokens in a single dashboard. Keep a close eye on the market. Compare service providers. Track performance. Get timely alerts. Build your portfolio with confidence.

Why older setup instructions may not match

Uniswap maintainers noted in a 2025 repository issue that local-development guidance and the contribution guide had been updated. That history is a reason to use the current README rather than copy old setup snippets. In particular, instructions for a legacy V1 repository should not be presented as configuration for the current web app.

Quick Recap

SaleBestseller No. 1
Ledger Nano X - Classic Crypto Wallet with Bluetooth
Ledger Nano X - Classic Crypto Wallet with Bluetooth
Genuine Check: confirm your signer is authentic during setup with the Ledger Wallet app.
$79.00

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.