ZapCircle - Behavior-Driven Development with LLMs

🧪 Local Code Review Before You Push

Get LLM-powered feedback on your code before you create a pull request.

Run npx zapcircle review to:

• Catch mistakes before your team sees them
• Write cleaner, more consistent code
• Save reviewer time by fixing issues upfront

ZapCircle works with any Git project and gives you behavior-aware comments.

npx zapcircle review

✨ You can even integrate it into your pre-commit workflow or CI pipeline.

🔍 Learn More →

---

How It Works

1. ✏️ Write your .zap.toml file describing the component’s behavior
2. ⚙️ Run zapcircle generate to create the React component
3. ✅ Use or edit the generated component as needed

Example Behavior → Code

name = "LoginForm"
behavior = """
Display an email and password input. Validate that both fields are filled.
Show an error if login fails. Submit form on Enter.
"""

export function LoginForm() {
  const [email, setEmail] = useState("");
  const [password, setPassword] = useState("");
  const [error, setError] = useState("");

  const handleSubmit = () => {
    if (!email || !password) {
      setError("Please fill in both fields");
      return;
    }
    // submit login...
  };

  return (
    <form onSubmit={handleSubmit}>
      <input type="email" value={email} onChange={e => setEmail(e.target.value)} />
      <input type="password" value={password} onChange={e => setPassword(e.target.value)} />
      {error && <div>{error}</div>}
      <button type="submit">Login</button>
    </form>
  );
}

Start Here

🧭 Begin the Journey →

Developer Guides

Getting Started

Set up ZapCircle and integrate it into your project. Read

Create Behaviors

Learn how to define and manage behaviors with .zap.toml. Read

Generating Code

Automatically generate React components from behaviors. Read

Generating Tests

Combine your React components with their underlying behaviors to generate better unit tests. Read

Updating Code

Describe changes to your code’s behavior and let ZapCircle update the implementation. Read

Reviewing Pull Requests

Use ZapCircle in CI to get behavior-aware code reviews from LLMs. Read

Creating New Projects

Turn an idea into a working React app with Tailwind, routing, and behaviors. Read

Example Behaviors

Explore front-end components with behavior-driven specifications.

Login Form

Behavior-driven login experience. Example

Search Bar

Debounced input field with API calls. Example

Button

Flexible button with variants and loaders. Example

Modal Dialog

Accessible dialog for messages or forms. Example

Notification Banner

Alert and success banner with dismiss. Example

Concepts

Behavior-Driven Development (BDD) Learn how Behavior-Driven Development works in 2025 with ZapCircle and LLM-powered code generation.

Developer Workflow Integrate ZapCircle into your dev workflow to streamline collaboration and reduce drift.