Eddy Dev Handbook

Welcome to the Eddy Developer Handbook! This comprehensive guide provides everything you need to understand, develop, and contribute to the Eddy platform.

Getting Started

What is Eddy?

Understanding Eddy's core concepts and the game engine metaphor

Developer Onboarding

Complete 4-week onboarding guide for new developers

Code Practice & Protocols

Code Guidelines

Comprehensive conventions for file structure, API endpoints, naming, and code style

Good Development Practices

Core principles for becoming a great engineer

LLM Usage Guidelines

Pragmatic Programming

Code Style & Best Practices

Our Codebase & Architecture

Frontend App Map

Workflow Builder Architecture

Block System Architecture

Sheet Architecture

Session Progression & Roles

Session Architecture

Technical Reference

API Endpoints

Database Schema

Testing

E2E Testing

Workflow Validation

Workflow Export

Workflow Import

Start Links

Session State Computation

Assignments

Code Audits

Builder Audit

Sheets Audit

Sheet Section Audit

Record Lists Audit

Data Fetching Audit

Worst Parts of the Codebase

Proposals

Process Intelligence

Real-Time Cursors

Workflow Versioning

Relational Virtual Tables

Documentation Roadmap

Reflections

Eddy is a Game Engine

LLM Reflections