firecrawl-local-dev-loop

Configure FireCrawl local development with hot reload and testing.Use when setting up a development environment, configuring test workflows,or establishing a fast iteration cycle with FireCrawl.Trigger with phrases like "firecrawl dev setup", "firecrawl local development","firecrawl dev environment", "develop with firecrawl".

⭐939stars🔀114forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the setup of a high-efficiency local development environment for FireCrawl. It streamlines the creation of standardized project structures, configures environment variables, and implements a fast iteration loop featuring hot reloading and Vitest-based testing. By providing a pre-configured boilerplate and testing suite, it enables developers to build, debug, and scale FireCrawl integrations rapidly while following industry best practices like TypeScript support and API response mocking.

Use Cases

  • Rapidly bootstrapping a new FireCrawl project with a professional directory structure and essential configuration files.
  • Establishing a 'hot reload' development cycle where code changes in FireCrawl scripts are instantly reflected without manual restarts.
  • Setting up a robust automated testing framework using Vitest to validate FireCrawl logic and mock API responses for cost-effective debugging.
  • Standardizing environment variable management across development teams using .env templates and local secret configurations.
namefirecrawl-local-dev-loop
description|
allowed-toolsRead, Write, Edit, Bash(npm:*), Bash(pnpm:*), Grep
version1.0.0
licenseMIT
authorJeremy Longshore <jeremy@intentsolutions.io>

FireCrawl Local Dev Loop

Overview

Set up a fast, reproducible local development workflow for FireCrawl.

Prerequisites

  • Completed firecrawl-install-auth setup
  • Node.js 18+ with npm/pnpm
  • Code editor with TypeScript support
  • Git for version control

Instructions

Step 1: Create Project Structure

my-firecrawl-project/
├── src/
│   ├── firecrawl/
│   │   ├── client.ts       # FireCrawl client wrapper
│   │   ├── config.ts       # Configuration management
│   │   └── utils.ts        # Helper functions
│   └── index.ts
├── tests/
│   └── firecrawl.test.ts
├── .env.local              # Local secrets (git-ignored)
├── .env.example            # Template for team
└── package.json

Step 2: Configure Environment

# Copy environment template
cp .env.example .env.local

# Install dependencies
npm install

# Start development server
npm run dev

Step 3: Setup Hot Reload

{
  "scripts": {
    "dev": "tsx watch src/index.ts",
    "test": "vitest",
    "test:watch": "vitest --watch"
  }
}

Step 4: Configure Testing

import { describe, it, expect, vi } from 'vitest';
import { FireCrawlClient } from '../src/firecrawl/client';

describe('FireCrawl Client', () => {
  it('should initialize with API key', () => {
    const client = new FireCrawlClient({ apiKey: 'test-key' });
    expect(client).toBeDefined();
  });
});

Output

  • Working development environment with hot reload
  • Configured test suite with mocking
  • Environment variable management
  • Fast iteration cycle for FireCrawl development

Error Handling

Error Cause Solution
Module not found Missing dependency Run npm install
Port in use Another process Kill process or change port
Env not loaded Missing .env.local Copy from .env.example
Test timeout Slow network Increase test timeout

Examples

Mock FireCrawl Responses

vi.mock('@firecrawl/sdk', () => ({
  FireCrawlClient: vi.fn().mockImplementation(() => ({
    // Mock methods here
  })),
}));

Debug Mode

# Enable verbose logging
DEBUG=FIRECRAWL=* npm run dev

Resources

Next Steps

See firecrawl-sdk-patterns for production-ready code patterns.