ppuzzl.dev

Getting Started

The PPUZZL SDK provides a unified interface for building procedural puzzle systems. Install, configure, and deploy in under five minutes.

npm install @ppuzzl/core

Architecture

Built on a composable pipeline of generators, validators, and renderers. Each component operates independently, communicating through typed event streams.

Core Concepts

Seeds, grids, constraints, and solvers form the four pillars. Every puzzle begins with a seed and ends with a verifiable solution path.

const puzzle = ppuzzl.generate({ seed: 'a7f3', grid: 8 });

Visual Editor

Drag-and-drop puzzle construction with real-time constraint validation. See your puzzle take shape as you define rules.

Solver Debugger

Step through solution algorithms frame by frame. Visualize backtracking, constraint propagation, and arc consistency in real time.

ppuzzl.debug({ mode: 'step', visualize: true });

REST API

Generate puzzles on demand via HTTP. Specify difficulty, dimensions, symmetry constraints, and solution uniqueness guarantees.

GET /api/v1/generate?seed=random&difficulty=hard

WebSocket Streams

Subscribe to real-time puzzle generation events. Stream partial solutions, constraint violations, and completion notifications.