GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • solarch-dev
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles

This view

  • Original page
  • New address

GeezerVison is showing github.com — solarch.dev

README.md

Solarch Logo   Solarch  

Bridging diagrams and code via a strict rules engine to stop AI errors.


Your entire workspace, on one canvas. | AI that ships. No more hallucinations.


License GitHub Stars Last Commit


Solarch — AI builds rule-validated architecture from a single prompt

Why Solarch?   •   Gallery   •   Features   •   Philosophy   •   Get Involved



✦ Why Solarch?

Most AI tools generate code and hope the architecture catches up. Solarch flips that.

It generates architecture first — grounded in a library of canonical patterns, validated by a strict Rules Engine, refined through a self-correcting loop. The AI proposes; the rules verify; only correct graphs ever land on the canvas.

  • One canvas for the whole system: 21 node families — controllers, services, repositories, tables, DTOs, queues — and the 16 semantic edges between them.
  • AI Architect grounded in GraphRAG: an agentic LLM pipeline pulls from a vector-indexed pattern library. It never starts from a blank context, never invents an API surface.
  • Rules Engine that refuses to lie: 32 whitelist rules, 7 anti-patterns, 3 conditional checks. Frontends can't talk to tables. Controllers can't reach repositories. Period.
  • Self-correcting loop: Rules rejection feeds back into the agent; the AI revises and tries again until the graph is clean — or never commits.
  • Live Instruct Mode: Switch modes and chat with your design. Every answer cites the exact nodes; chips focus the canvas in real time.
  • Single-home + reference tabs: Each node lives in one tab. Other tabs import it as a reference, not a copy. One source of truth, multiple views.
  • Type-safe from DB to button: Zod schemas at the backend, OpenAPI in the middle, openapi-fetch on the frontend. The API contract is a compile-time check.

✦ Gallery

1. Start with a prompt
Type what you want to build. The AI Architect kicks in: pulls canonical patterns, plans the graph, and applies it through the Rules Engine.

AI input typing
2. Sketch → architecture (preview)
Freeform sketch becomes a structured graph on Refine. Native sketch surface on the roadmap; the AI-driven refine path runs today.

Sketch to architecture
3. Watch it build itself
Nodes pop in with zen animations, edges flow with the right semantics — every relationship rule-validated before it commits.

AI canvas building
4. Pattern library (preview)
A standalone constructor library is on the roadmap. The same canonical patterns already power GraphRAG behind the scenes today.

Pattern library
5. Connect anything — legally
Hover a port, drag, snap. The Rules Engine rejects illegal connections instantly. Semantic edges carry meaning, not generic arrows.

Edge connecting
6. Every node, purpose-built editor
Double-click any node. Column grids for tables, method tables for services, endpoint rows for controllers — no generic JSON forms.

Inspector reveal
Ask your architecture anything
Switch to Instruct mode and chat with your design. Every citation is a live chip that focuses the canvas with a soft halo.

Instruct mode

✦ Features

AI & Rules
  • AI Architect: agentic LLM loop with atomic tool calling
  • Rules Engine: 32 whitelist · 7 blacklist (ERR_001..007) · 3 conditional
  • GraphRAG: vector search over a canonical pattern library
  • Self-correction loop: rejection feeds back into agent state, AI revises
  • Vector-native Neo4j: embeddings + graph in one DB, no extra Pinecone
  • Local embeddings: compact multilingual sentence-transformer, on-box, 384-d
  • 21 node families: Table, DTO, Model, Service, Worker, Controller, Repository, Cache, Middleware, and more
  • 16 semantic edges: CALLS, QUERIES, WRITES, PUBLISHES, SUBSCRIBES, THROWS...
Workspace & UI
  • Custom Canvas 2D: 60fps, dual-canvas, viewport culling, devicePixelRatio
  • AI Omni-Bar: Agent (build) + Instruct (Q&A) modes, SSE streaming
  • Live node chips: citations focus the canvas with a soft halo
  • Purpose-built inspectors: per-type editors (4 today, the rest on roadmap)
  • Multi-tab workspace: single-home model + cross-tab references, not copies
  • Edge bundling & routing: obstacle-aware bezier and elbow paths
  • Type-safe API client: Zod → OpenAPI → openapi-fetch + openapi-typescript
  • Aydınlık Blueprint design: warm paper, semantic family colors, hairline grid, Satoshi + JetBrains Mono

✦ The Philosophy

Solarch doesn't fight AI hallucination — it makes hallucination structurally impossible.

The industry has spent two years asking LLMs to write code. The result: confident hallucinations, ghost APIs, codebases that compile but lie. Hallucination isn't a tuning problem — it's a category error.

Architecture is the level where structure is provable. A controller calls a service. A service queries a repository. A repository writes a table. These relationships are either present or not. They can't be hallucinated.

Solarch stacks three layers that, together, leave no room for an AI to invent something that doesn't exist:

  1. GraphRAG. The agent starts every request by retrieving canonical patterns from a vector-indexed library. No blank context, no improvisation from zero.
  2. Rules Engine. Every mutation passes a deterministic gate — 32 whitelist rules, 7 anti-patterns, 3 conditional checks. Illegal edges never land. The schema can't be coerced.
  3. Self-correction loop. When the Rules Engine rejects a draft, the violation message feeds back into the agent state. The AI revises until the graph is clean, or the request terminates without a commit.

The output isn't trustworthy code. It's provably correct structure.

Provable structure. Targeted intelligence. Zero hallucinated APIs.


✦ Get Involved

We welcome feedback, discussions, and contributions.

  • 💬 GitHub Discussions — Feature requests, design feedback, questions.
  • 🐛 Issues — Bug reports, regressions.
  • 🛠️ Contributing Guide — Local setup, conventions, commit style.

✦ License

PolyForm Noncommercial License 1.0.0 — © 2026 Ugur Akdogan.

Free for personal use, research, education, and non-profit organizations. Source is open: fork, learn, modify, share — go for it.
Commercial use requires a separate license — reach out at [email protected].


See. Understand. Plan.
In one shot.


Solarch.

Popular repositories Loading

  1. solarch solarch Public

    Diagram→code through a deterministic rules gate: the AI proposes, 50 rules verify, only valid architecture lands. Try it: app.solarch.dev

    TypeScript 47 1

  2. solarch-tools solarch-tools Public

    TypeScript 1

  3. .github .github Public

    Description of Solarch

Repositories

Loading
Type
Language
Sort
Showing 3 of 3 repositories
  • solarch Public

    Diagram→code through a deterministic rules gate: the AI proposes, 50 rules verify, only valid architecture lands. Try it: app.solarch.dev

    Uh oh!

    There was an error while loading. Please reload this page.

    solarch-dev/solarch's past year of commit activity
    TypeScript 47 1 0 0 Updated Jul 2, 2026
  • solarch-tools Public

    Uh oh!

    There was an error while loading. Please reload this page.

    solarch-dev/solarch-tools's past year of commit activity
    TypeScript 1 0 0 0 Updated Jun 23, 2026
  • .github Public

    Description of Solarch

    Uh oh!

    There was an error while loading. Please reload this page.

    solarch-dev/.github's past year of commit activity
    0 0 0 0 Updated Jun 5, 2026

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Uh oh!

There was an error while loading. Please reload this page.

Most used topics

Loading…

Uh oh!

There was an error while loading. Please reload this page.

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.