Introduction to Rekhic

Rekhic is a local-first visual workspace built specifically for software engineers and systems architects. It gives you an infinite canvas tailored for drawing, modeling, and communicating technical architectures without the friction of generic whiteboarding tools.

Unlike general-purpose whiteboards, Rekhic treats architecture as structured technical data. You can design systems from scratch on a blank canvas, or automatically bootstrap architecture diagrams from existing project assets:

README Files: Extract Mermaid diagrams and structured technical sections into editable topologies.
Source Code: Analyze dependencies, service boundaries, and data stores directly in your browser.
Public GitHub Repositories: Inspect public repositories without requiring credentials or server-side clones.
Architecture Documentation: Export visual system diagrams into production-grade Markdown documentation and ADRs.

What Problem Does Rekhic Solve?

Most generic drawing tools provide boundless creative freedom, which is helpful for graphic designers but counterproductive for engineers. You end up spending more time nudging boxes and hunting for cloud provider SVGs than reasoning about system design and trade-offs.

Traditional UML and modeling suites, on the other hand, often enforce rigid, dated notations that slow down agile documentation and engineering reviews.

Rekhic combines:

Developer-focused primitives: Pre-styled architecture nodes, rich technology icons (AWS, databases, frameworks), and orthogonal connectors.
Local-first privacy: Code and documents are parsed directly in your browser. No source code or README contents are uploaded to a Rekhic backend.
Speed of execution: Keyboard-driven shortcuts, auto-layout algorithms, and one-click Markdown documentation export.

Core Capabilities

text
       Start From Any Source Asset
  ┌──────────────┬──────────────┬──────────────┐
  │    README    │ Source Code  │ Public Repo  │
  └──────┬───────┴──────┬───────┴──────┬───────┘
         │              │              │
         ▼              ▼              ▼
     Local Browser Architecture Analysis Engine
                        │
                        ▼
            Infinite Rekhic Canvas
        (Edit, Group, Re-route, Auto-Layout)
                        │
         ┌──────────────┴──────────────┐
         ▼                             ▼
   Image Exports               Markdown Documentation
   (PNG, SVG, JSON)            (ADRs, System Design Specs)

1. Canvas Architecture Modeling

An XYFlow-powered infinite workspace with smart orthogonal connectors, technology icon search, layer ordering, and alignment snapping.

2. Local-First Architecture Detection

Deterministic AST and pattern analyzers detect services, databases, queues, and external APIs right inside your client session.

3. Bi-Directional Documentation

Visual diagrams can be exported to clean GitHub-Flavored Markdown documentation detailing applications, data stores, external dependencies, and relationship flows.

What Rekhic Is Not

To establish clear expectations:

Rekhic is not an AI model or LLM generator. All current architecture parsing is deterministic, local-first, and rule-based.
Rekhic does not upload your source code to any remote servers. Analysis runs 100% client-side in your browser.
Rekhic does not access private GitHub repositories. It integrates exclusively with public repositories via unauthenticated public API calls.
Rekhic does not claim architectural omniscience. Automated architecture detection is an analysis intended to save scaffolding time; engineers should review and refine generated diagrams.

Getting Started

Ready to begin?

Quick Start Guide - Create your first diagram in under 5 minutes.
Creating Your First Diagram - Deep dive into nodes, handles, and connectors.
README to Diagram - Turn project documentation into an editable architecture model.

Quick Start Guide