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 the installation, configuration, and architecture of the Ideon platform.

Documentation Structure

• Installation: Deployment guides using Docker and Docker Compose.
• Architecture: Technical overview of the stack (Next.js, WebSocket, Yjs, Kysely).
• Concepts: Explanation of core data models: Workspaces, Projects, and Blocks.
• Guides: User manuals for project management and collaboration features.

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.