Arshu Assembler

A Polyglot Declarative Framework for App Creation

View on GitHub Get Started View Rules

About

Arshu Assembler is a polyglot declarative framework for app creation, inspired by abstractions from Mustache, React, and HTMX. This project is a multi-language implementation of the original Arshu Assembler, recreated using AI-assisted development in multiple languages ultimately to replace/enhance the original.

This repository represents current Phase 2 of a larger project vision (which may/may not be possible) to build a polyglot web framework.

Project Roadmap - 7 Phases
  • Phase 1: Arshu Proxy (Multi-language Proxy) - Completed

    Validated if LLM can be used to generate web related code in multiple languages.

  • Phase 2: Arshu Static Assembler (This repository - Static Assembly) - Completed

    The actual start of the project to use LLM to build a static assembler to assemble HTML in various languages with multiple implementations, complete with 5 initial rules.

  • Phase 3: Arshu Data Assembler (This repository - Data Assembly) - In Development

    Implement abstractions of static data inheritance (parent/global/context) across components as well as assembling components from different JSON for the same markup.

  • Phase 4: Dynamic Server-Side Assembly - Planned

    Make the data modifiable and implement dynamic server-side generation of HTML with ability to drill down and generate any leaf or child hierarchy of the component tree.

  • Phase 5: Integrated Full-Stack Framework - Planned

    Truly integrate client side and server side, making assembler components assemblable in client (JS) and/or server (C#/Rust/Go/PHP/Node) depending on requirements.

  • Phase 6: Integrated Multi-Connect Framework - Planned

    Provide common abstractions for communicating between components using Ajax/WebSocket/WebRTC/WebTransport.

  • Phase 7: Integrated Revenue Centric Deployment - Planned

    Provide common abstractions for deployment (Initial Multi Provider/Subsequent Zero Downtime/Clonable), Measurement (Usage/Performance) with integration to Authentication/Authorization/Payment Systems as a sample project to be deployed in Usage-based infrastructure in fly.io/unikraft.cloud/baremetal/virtual machine.

Important Notes

This is a Sustainable Revenue Centric Instead of Cost Centric Open Source (MIT Licensed) project.

No pull requests will be accepted for this repository. If you want to collaborate, fork this repository and share your enhancement details via an issue.

All implementations are AI-generated with focus on architecture, testing, validation, and performance. Implementations may not be optimal but outputs are accurate and validated.

Note: I am only familiar with C#, which I used as the prompt for all other languages. I am not familiar with idioms or conventions in other languages.

Original Demos

Demo of the original Assembler Framework is deployed in:

UI Source available in Arshu Data GitHub

Intermediate Goals

The primary goal is to recreate the existing Arshu Assembler so that I can improve the abstraction for assembly since I have lots of ideas but lack the time to implement them.

The secondary goal is to recreate demo applications Arshu Data, Arshu Hub, and the Loyalty Management Application and other apps which I am developing to be fully recreated in AI so that I can implement features faster using AI.

Ultimate Goal

Find abstractions which improve reusability in developing applications and can lead to implementing an independent supply chain in software development due to improved abstractions that clearly separate building from assembly.

Articles

Explore in-depth articles and analysis related to the Arshu Assembler framework.

Package Usage Guide

Published: November 2025 | Topic: Getting Started
Complete guide to using Arshu Assembler packages in your local projects. Learn how to install and integrate the assembler in Node.js, PHP, C#, Go, and Rust with detailed examples and best practices for each language.
Read Guide →

Is Rust Slow? A Performance Comparison

Published: October 21, 2025 | Topic: Performance Analysis
A comprehensive micro-benchmark analysis comparing template assembly performance across C#, Rust, Go, Node.js, PHP, and JavaScript. Discover surprising insights about Rust's performance in Normal vs PreProcess engines, and why language choice matters less than algorithm design for this workload.
Read Article →

More Articles Coming Soon

Future Topics
Stay tuned for more articles on AI-assisted development, polyglot architecture patterns, usage-based infrastructure, and performance optimization strategies.

Live Demos

Try the Arshu Assembler in action with live demos deployed on fly.io:

⚠️ Note

All projects have idle tracking implemented with auto shutdown after 10 seconds of inactivity due to deployment on fly.io (Usage-Based Infrastructure).

Language Type Demo Link
JavaScript Client Side Assembly jsassembler.fly.dev
C# Server Side Assembly csharpassembler.fly.dev
Rust Server Side Assembly rustassembler.fly.dev
Go Server Side Assembly goassembler.fly.dev
Node.js Server Side Assembly nodeassembler.fly.dev
PHP Server Side Assembly phpassembler.fly.dev

Core Features

The framework implements a component-oriented architecture for composing markup and data.

Component Composition

  • Direct Composition: Directly compose markup
  • Slotted Composition: Compose markup into numbered slots
  • Context Composition: Compose markup based on view context

Data Composition

  • JSON Key Composition: Merge markup with JSON objects
  • JSON Array Composition: Render markup iteratively with JSON arrays

Dual Engine Architecture

  • Normal Engine: Handles both parsing and merging
  • PreProcess Engine: Separates parsing from merging for better performance

Polyglot Support

  • C# (.NET 10.0+)
  • Rust
  • Go (1.21+)
  • Node.js (18+)
  • PHP (8.0+)
  • JavaScript (Client-side)

Project Status

All language implementations are feature complete for the previous phase (Phase 2 - Static Assembler):

C#
✅
Rust
✅
Go
✅
Node.js
✅
PHP
✅
JavaScript
✅

Implementation Modules

Each language implementation includes:

  • Assembler: Core static site generation logic ✅
  • AssemblerTest: Comprehensive test suite ✅
  • AssemblerWeb: Web server exposing the assembler API ✅

Quick Start

Get started with Arshu Assembler in your preferred language:

Installation

git clone https://github.com/Srid68/Arshu.Assembler.git
cd Arshu.Assembler

Run Tests (Example: C#)

cd csharp/AssemblerTest
dotnet run

Run Web Server (Example: C#)

cd csharp/AssemblerWeb
dotnet run

For detailed instructions for each language, see the Getting Started Guide.

Collaboration

I am interested in collaborating on the following topics:

Contact: srid68 [at] gmail.com

Pair Programming with AI: $25 USD per hour session for recreating this project

Subscription Freelancing: $250 USD/Month for up to $10,000 USD worth of work