> For the complete documentation index, see [llms.txt](https://nakis-organization.gitbook.io/naki-wallet/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nakis-organization.gitbook.io/naki-wallet/installation-and-setup.md).

# Installation and Setup

## Installation and Setup 

### Prerequisites 📋

Before installing Naki Wallet, ensure you have:

* Node.js (v18 or later)
* npm or [bun](https://bun.sh) package manager
* Git
* iOS Simulator (macOS) or Android Emulator (optional for local testing)
* Or directly on your mobile:
  * [Expo Android](https://play.google.com/store/apps/details?id=host.exp.exponent\&hl=es_CR\&pli=1) o [Expo iPhone](https://apps.apple.com/us/app/expo-go/id982107779)

### Local Installation from Repository 💻

1. **Clone the repository**

```bash
clone https://github.com/AnunnakisLabs/nakiWallet.git
cd nakiWallet
```

2. **Install dependencies**

```bash
bun install
```

3. **Configure environment variables** Update the `app.config.ts` file with your Privy credentials:

```typescript
// in app.config.ts
extra: {
  privyAppId: "YOUR_PRIVY_APP_ID",
  privyClientId: "YOUR_PRIVY_CLIENT_ID",
},
```

4. **Run on device or simulator**

```bash
bun start
```

### Quick Start with Expo Go (QR Code) 📱

For judges and testers who want to quickly access the app without local setup:

1. Download [Expo Go](https://expo.dev/client) on your iOS or Android device
2. Scan our project QR code

<figure><img src="/files/7CFkEEolvFrisI9wPANe" alt=""><figcaption></figcaption></figure>

1. The app will load directly on your device

This method provides the fastest way to experience Naki Wallet without any development setup.

### Testing Network Information ⚙️

Naki Wallet currently uses Base Testnet with the following parameters:

* Network: Base Goerli Testnet
* Chain ID: 0x14a33 (84531 in decimal)
* RPC URL: <https://goerli.base.org>
* Currency: USDC (Test version)

For testing purposes, you don't need to acquire real assets - our app simulates the wallet functionality with testnet tokens.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nakis-organization.gitbook.io/naki-wallet/installation-and-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.