IMPORTANT FOR NON-DEVELOPERS: Elytro is committed to accessibility for everyone.

If you are not a developer and want to run Elytro locally, please read GETTING_STARTED_FOR_NON_DEVS.md first for a simple, step-by-step guide!

Elytro Monorepo

---

Quick Start Script (Recommended for NON- or Junior Developers)

You can set up and run everything with a single command using the provided script:

./quickstart.sh

• This script will:
  1. Check/install prerequisites
  2. Install dependencies
  3. Start both the extension and recovery app dev servers
  4. Show you how to load the extension in Chrome

If you see a permissions error, run:

chmod +x quickstart.sh

---

Elytro is a modular ERC-4337 smart wallet system for the EVM ecosystem. This monorepo contains the browser extension wallet and the social recovery web application.

Applications

apps/extension

A Chrome extension implementing an ERC-4337 smart contract wallet. Built with React, TypeScript, Vite, and Tailwind CSS. Supports multi-chain access, account abstraction, and contact-based recovery.

See apps/extension/README.md for details.

apps/recovery

A Next.js 14 web app that enables secure wallet recovery via trusted contacts. Guides users through multi-step verification and on-chain recovery.

See apps/recovery/README.md for details.

Here is an example link to show you how it works.

Setup

Recommended Environment

To ensure compatibility, use the following versions:

• Node.js: 22.15.x
• pnpm: 9.15.x

Check your versions with:

node -v
pnpm -v

Install Dependencies

pnpm install

Start Dev Servers

Run the extension:

pnpm --filter extension dev

Run the recovery app:

pnpm --filter recovery dev

Monorepo Structure

apps/           # Application projects
├── extension/  # Elytro Chrome extension
├── recovery/   # Recovery web interface

packages/       # Shared libraries (WIP, do not use)
configs/        # Shared config (eslint, tailwind, tsconfig, etc.)

Tooling

• pnpm for workspace management
• Turborepo for task orchestration
• TypeScript with strict mode enabled
• ESLint / Prettier for code formatting
• Husky for optional Git hook support

License

GNU