Start > Local development

Local development

Run the Quovra app and program tooling locally.

Local development

Run Quovra locally when you want to inspect the frontend, SDK helpers, keeper scripts, or Anchor program.

Prerequisites

  • Node.js 20.9 or newer.
  • npm.
  • Rust stable.
  • Solana CLI configured for devnet.
  • Anchor 0.31.
  • A devnet keypair for on-chain actions.

1. Clone the repository

bash
git clone https://github.com/mystiquemide/quovra.git
cd quovra

Expected result:

text
README.md
app/
onchain/
docs/

2. Install the app

bash
cd app
npm install

Expected result:

  • Dependencies install without peer-dependency errors.
  • node_modules/ exists under app/.

3. Configure the app

Create a local env file:

bash
cp .env.example .env.local

Minimum local variables:

bash
NEXT_PUBLIC_SOLANA_NETWORK=devnet
NEXT_PUBLIC_SOLANA_RPC=https://api.devnet.solana.com
SOLANA_RPC=https://api.devnet.solana.com
QUOVRA_FAUCET_SECRET='[server-only mint authority JSON array]'

> Warning: Never commit QUOVRA_FAUCET_SECRET, TxLINE JWTs, API tokens, or private keypairs.

4. Run the app

bash
npm run dev

Open:

text
http://localhost:3000

Expected result:

  • The landing page loads.
  • /markets renders market cards.
  • /docs renders technical docs.
  • /sdk renders SDK usage.

5. Build the on-chain program

bash
cd ../onchain
anchor build

Expected result:

  • Anchor compiles the Quovra program.
  • The generated IDL matches app/src/idl/quovra.json when synchronized.

6. Run tests

App:

bash
cd ../app
npm run lint
npm run test
npm run build

On-chain:

bash
cd ../onchain
cargo fmt --check
cargo test --workspace

Expected result:

  • Lint passes.
  • Vitest passes.
  • Next.js production build completes.
  • Rust tests pass.

Common mistakes

  • Using mainnet RPC while testing devnet markets.
  • Running the faucet without QUOVRA_FAUCET_SECRET.
  • Forgetting to use Node 20.9 or newer.
  • Committing generated keypairs or .env.local.

Related pages

Search keywords

local development, npm install, Anchor build, Solana devnet, environment variables

Last updated: [YYYY-MM-DD]