browse

Files (1)

• SKILL.md

SKILL.md (first lines)

# Browse — Playwright E2E Testing for SolanaOS Hub

Browser automation and end-to-end testing skill for the SolanaOS NanoHub, powered by Playwright.

## Quick Start

```bash
# Install Playwright browsers
npx playwright install chromium

# Run E2E tests
bun run test:e2e

# Run with UI mode
npx playwright test --ui

# Generate tests interactively
npx playwright codegen https://seeker.solanaos.net
```

## NanoHub Test Configuration

The NanoHub uses a dual config setup:

### Playwright Config (`playwright.config.ts`)

Browser-based E2E tests against the built frontend.

```typescript
import { defineConfig, devices } from '@playwright/test'

export default defineConfig({
  testDir: './e2e',
  testMatch: /.*\.pw\.test\.ts/,
  timeout: 60_000,
  expect: { timeout: 10_000 },
  fullyParallel: true,
  retries: process.env.CI ? 2 : 0,
  use: {
    baseURL: process.env.PLAYWRIGHT_BASE_URL || 'http://127.0.0.1:4173',
    trace: 'retain-on-failure',
  },
  webServer: {
    command: 'bun run preview -- --host 127.0.0.1 --port 4173',
    url: 'http://127.0.0.1:4173',
    reuseExistingServer: !process.env.CI,
  },
  projects: [
    { name: 'chromium', use: { ...devices['Desktop Chrome'] } },
  ],
})
```

### Vitest E2E Config (`vitest.e2e.config.ts`)

Node-based E2E tests for CLI and API validation (no browser needed).

```bash
bun vitest run -c vitest.e2e.config.ts
```

## NanoHub Routes to Test

| Route | Auth | What to verify |
|-------|------|----------------|
| `/` | No | Landing page renders, navigation works |
| `/launch` | No | Boot sequence animation, CTA links |
| `/mobile` | No | Seeker mobile walkthrough renders |
| `/skills` | No | Skill cards load from Convex |
| `/souls` | No | Soul cards load from Convex |
| `/ipfs` | No | IPFS Hub page renders, wallet input works |
| `/agents` | No | Agent directory loads public agents |
| `/dashboard` | Yes | Wallet connect, agent factory, pairing |
| `/upload` | Yes | Skill publish flow with file upload |
| `/settings` | Yes | User preferences, agent config |
| `/mining` | No | BitAxe fleet dashboard renders |
| `/strategy` | No | Strategy builder loads |
| `/create` | Yes | Skill creator wizard |
| `/auth/callback` | No | GitHub OAuth redirect handling |

## Writing Hub Tests

### Public Route Test

```typescript
import { test, expect } from '@playwright/test'

test('IPFS Hub page loads', async ({ page }) => {
  await page.goto('/ipfs')
  await expect(page.locator('h1')).toContainText('Private IPFS')
  await expect(page.locator('.gallery-stat-card')).toHaveCount(4)
})

test('agent directory shows cards', async ({ page }) => {
  await page.goto('/agents')
  await expect(page.locator('h1')).toContainText('Registered')
  // Wait for Convex query
  await page.waitForSelector('.agent-card', { timeout: 10_000 })
})

test('skill search works', async ({ page }) => {
  await page.goto('/skills')
  await page.locator('input[type="search"]').fill('solanaos')
  await page.waitForSelector('.skill-card')
  await expect(page.locator('.skill-card')).toHaveCount.greaterThan(0)
})
```

### Authenticated Route Test

```typescript
import { test, expect } from '@playwright/test'

// Use storage state from auth setup
test.use({ storageState: 'e2e/.auth/user.json' })

test('dashboard loads for authenticated user', async ({ page }) => {
  await page.goto('/dashboard')
  await expect(page.locator('.dashboard-section')).toBeVisible()

From x402agent/SolanaOS, MIT.

More from x402agent/SolanaOS