Ava Labs Mobile

Welcome to the Mobile Team Repo

---

📦 Packages

This repository is a monorepo that we manage using Yarn workspaces.

Package	Description
@avalabs/core-mobile	Core Mobile app
@avalabs/k2-alpine	Mobile Design System
eslint-plugin-avalabs-mobile	Shared ESLint plugin
@avalabs/tsconfig-mobile	Shared TypeScript config

✅ Requirements

• Node.js >= 20.18 — install via volta or nvm

• Yarn — the repo pins Yarn 3.6.4 in .yarn/releases (via yarnPath), so any modern Yarn launcher delegates to it:

  corepack enable
  

  or, if you prefer Homebrew: brew install yarn (Yarn >= 1.22 forwards to the pinned version automatically).

Everything else (Xcode, Android Studio, Ruby, AWS CLI, …) is only needed to build the app itself — see the core-mobile README.

⚡ Quickstart

1. Clone the repo

   git clone git@github.com:ava-labs/core-mobile.git && cd core-mobile
   

2. Install dependencies for all packages and run their setup scripts

   In the root directory, run:

   yarn install && yarn setup
   

3. Follow the specific instructions in each package to build/run it:

   • core-mobile — the wallet app
   • k2-alpine — the design system / Storybook

📖 Tips

1. You can use these shortcuts to quickly run a command for packages/core-mobile and packages/k2-alpine

   yarn core <COMMAND>
   yarn k2 <COMMAND>
   
   e.g yarn core start && yarn core ios
   

2. To quickly remove all the node_modules folders, you can run

   ./scripts/remove-node-modules.sh