Skip to content

nunosilva-dev/architex

Repository files navigation

Architex

From Prompt to Production-Ready Architecture.

Architex is an intelligent, local-first system architecture engine. It transforms natural language descriptions into professional, structured architecture diagrams and decision records (ADRs) instantly.

Designed for software architects, developers, and engineering managers who need to visualize complex systems rapidly without dragging boxes around.

Key Capabilities

🧠 Hybrid AI Intelligence

Architex leverages a dual-engine approach to balance cost, speed, and privacy:

  • Pollinations (Free): Zero-config, free-tier access for rapid prototyping.
  • Google Gemini (Flash 2.5): Connect your own API key for high-fidelity, context-aware architectural reasoning.

🔒 Local-First & Private

Your API keys and architectural data live in your browser. Architex stores sensitive configuration in localStorage, adhering to a strict privacy-first philosophy. No middleman servers store your keys.

🛡️ Self-Healing Diagrams

LLMs often hallucinate invalid syntax. Architex includes a robust Repair Engine that:

  • Automatically detects Mermaid syntax errors.
  • Sanitizes node labels and relationships.
  • Fixes common structural issues on the fly, ensuring your diagrams always render.

⚡ Interactive Workspace

  • Split-View Interface: Chat with the architect on the left, view live diagrams on the right.
  • Architecture Decision Records (ADRs): Every diagram comes with a generated ADR, explaining why technical choices were made (Context, Decisions, Consequences).
  • Export & Share: Generate shareable URLs or download your diagrams as code/images.

Visual Example

Architex generates industry-standard Mermaid diagrams:

graph TD
    Client["User Client (Mobile/Web)"] -->|HTTPS/REST| API["API Gateway"]
    API -->|Auth| Auth["Auth Service (OAuth2)"]
    API -->|Load Balance| lb["Load Balancer"]
    lb --> S1["Service A (Core)"]
    lb --> S2["Service B (Analytics)"]
    S1 --> DB[("Primary Database (Postgres)")]
    S2 --> Cache[("Redis Cache")]
    
    subgraph Infrastructure
    S1
    S2
    end
Loading

Use Cases

  • System Design Interviews: Quickly visualize solutions to "Design Uber" or "Design a URL Shortener."
  • Greenfield Projects: Bootstrap your initial architecture and ADRs in seconds.
  • Documentation: Generate maintainable diagrams-as-code for your existing repositories.
  • Legacy Refactoring: Describe an existing mess to get a structured map of what it should look like.

Architex is built with Next.js 14, Tailwind CSS, and Google Generative AI.