1. Seed Test Users

Purpose: Create or clean up test user accounts for QA and demo purposes, with optional interaction history and URL data. Combines seeding and cleanup into a single workflow.

Prerequisites:

  • .env.local with SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY
  • Target Supabase instance is accessible

Cost / Duration: $0 | 2-5 min

Prompt

Seed or clean up test user accounts.

Step 1 — Preview what would be created (dry-run):

```bash
bun scripts/seed-test-users.ts
```

Step 2 — Create QA test users:

```bash
bun scripts/seed-test-users.ts --execute --type=qa
```

Step 3 — Create demo test users (for stakeholder presentations):

```bash
bun scripts/seed-test-users.ts --execute --type=demo
```

Step 4 — Include interaction history (optional):

```bash
bun scripts/seed-test-users.ts --execute --type=qa --with-history --history-days=30
```

Creates 30 days of interaction history (challenge completions, streaks,
scores) for realistic demo data.

Step 5 — Skip URL seeding (optional):

```bash
bun scripts/seed-test-users.ts --execute --type=qa --skip-urls
```

Step 6 — Clean up all seeded test users:

```bash
bun scripts/seed-test-users.ts --cleanup --execute
```

Removes all previously created test users and their associated data.

Verify: Check the admin dashboard at `/users` to confirm test users are
present (or removed). Test users have `@eko.internal` email addresses.

Verification

  • Dry-run completes without errors
  • Test users appear in admin dashboard with @eko.internal emails
  • History data generated if --with-history was used
  • Cleanup removes all seeded users and associated data
  • No "User already exists" errors (run cleanup first if needed)

Back to index