ZKsync Nuxt Web3 Starter Configuration

This skill provides context and guidelines for working with a ZKsync Nuxt starter kit for Web3 applications.

Project Overview

A modern Web3 application starter built on:

Development Commands

Always use **npm** (not yarn or pnpm) for this project.

Start development server:

```bash

npm run dev

```

Architecture Guidelines

Library Preferences

1. **Use viem, not ethers**: All blockchain interactions should use viem (https://viem.sh/docs/getting-started)

2. **ZKsync with viem**: When using zksync-js, integrate with viem (https://matter-labs.github.io/zksync-js/latest/overview/index.html)

3. **Wagmi for wallets**: Use wagmi composables for wallet management (https://wagmi.sh/vue/getting-started)

4. **Wagmi Core for contracts**: Use wagmi/core for contract interactions (https://wagmi.sh/core/getting-started)

5. **TanStack Query**: Use for all data fetching needs (https://tanstack.com/query/latest/docs/framework/vue/overview)

UI Component Strategy

Auto-imports

The following are auto-imported and don't require explicit imports:

Import Aliases

Implementation Workflow

When given a task:

1. **Plan first**: Write out an implementation plan

2. **Ask questions**: Clarify any ambiguities before coding

3. **Skip validation**: Don't check types or run eslint during development

4. **Ignore formatting**: Post-commit hooks will handle formatting automatically

Code Quality Notes

Example Usage Patterns

**Blockchain interactions:**

```typescript

// Use viem for blockchain operations

import { parseEther } from 'viem'

// Use wagmi composables for wallet state

const { address, isConnected } = useAccount()

// Use TanStack Query for data fetching

const { data, isLoading } = useQuery({

queryKey: ['balance', address],

queryFn: () => fetchBalance(address)

})

```

**Auto-imported composables:**

```typescript

// No import needed - auto-imported from app/composables/

const { doSomething } = useMyComposable()

// No import needed - auto-imported from constants/

const CONTRACT_ADDRESS = MY_CONSTANT

```

Key Constraints