Introduction

Ideon is a self-hosted, collaborative workspace tool that organizes project resources on a spatial 2D canvas. It integrates various data types (text, code, external links, repository metadata) into a unified visual interface.

This documentation covers installation, configuration, architecture, security, and operations.

Documentation Structure

• Installation: Deployment guides using Docker and Docker Compose.
• Configuration: Environment variables and runtime settings.
• Architecture: Technical overview of the stack (Next.js, WebSocket, Yjs, Kysely).
• Security: Security headers, access control, and SSRF protection.
• Concepts: Explanation of core data models: Workspaces, Projects, and Blocks.
• Guides: User manuals for project management and collaboration features.
• Operations: Health checks, logs, backups, and upgrades.

Key Capabilities

• Spatial Canvas: Infinite 2D grid for positioning resources.
• Realtime Sync: CRDT-based state synchronization for multi-user editing.
• Block System: Modular content types (GitHub repos, Markdown notes, snippets).
• Versioning: Temporal state tracking for project history and snapshots.
• Self-Hosted: Docker-native distribution for private infrastructure.