Sutra

Sutra is a Sanskrit-style joke programming language inspired by Bhailang. It compiles to JavaScript using a lightweight regex-based compiler (no AST). The project includes a CLI tool published to npm, an interactive web playground built with Next.js and Chakra UI, and comprehensive documentation. Features include syntax highlighting, error handling with precise line/column reporting, and a responsive design with an ancient Indian aesthetic theme.

✨ Key Features

#

🔧 Core Compiler

- Regex-based Compiler: Lightweight compiler without parser libraries or AST
- JavaScript Output: Compiles Sanskrit-style code to standard JavaScript
- Error Handling: Precise error reporting with line and column information
- Clean Codebase: Maintainable implementation (~250 lines for compiler)

#

🌐 Interactive Web Playground

- Live Code Editor: Write and execute Sutra code in the browser
- Syntax Highlighting: Enhanced code readability
- Real-time Compilation: Instant JavaScript output
- Copyable Examples: Documentation with copyable code snippets
- Responsive Design: Works seamlessly on all devices
- Ancient Indian Theme: Beautiful UI with cultural aesthetic

#

📦 CLI Tool

- npm Package: Published as @tarunjawla/sutra
- Simple Commands: Easy-to-use CLI interface (sutra run file.skt)
- File Execution: Run Sutra files directly from command line
- Cross-platform: Works on Windows, macOS, and Linux

🏗️ Architecture

The project consists of three main components:

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Web Playground│    │   CLI Tool      │    │   Core Compiler │
│   (Next.js 14)  │    │   (Node.js)     │    │   (JavaScript)  │
│   React 18      │    │   npm package   │    │   Regex-based   │
│   Chakra UI     │    │                 │    │                 │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │
                    ┌─────────────▼─────────────┐
                    │   JavaScript Output       │
                    └───────────────────────────┘

🚀 Quick Start

#

Using the CLI

1. Install the package

bash
   npm install -g @tarunjawla/sutra
   

2. Create a Sutra file (file.skt)

sanskrit
   // Your Sanskrit-style code here
   

3. Run the file

bash
   sutra run file.skt
   

#

Using the Web Playground

Visit [sutra-lang.tarunjawla.com](https://sutra-lang.tarunjawla.com/) to use the interactive playground where you can write, compile, and execute Sutra code directly in your browser.

🛠️ Tech Stack

#

Core Compiler

- Node.js: Runtime environment
- JavaScript (ES6+): Modern JavaScript features
- Regex-based Compilation: No external parser libraries

#

Website/Playground

- Next.js 14: React framework with App Router
- React 18: UI library
- Chakra UI 2.8: Component library
- Framer Motion: Animation library
- Noto Sans Devanagari: Fonts for Sanskrit aesthetic

#

CLI

- Node.js: Runtime environment
- npm: Package distribution

📦 Project Highlights

- ✅ Built a working compiler from scratch
- ✅ Published to npm as @tarunjawla/sutra
- ✅ Deployed Next.js app to production
- ✅ Clean, maintainable codebase (~250 lines for compiler)
- ✅ Full documentation and examples
- ✅ Comprehensive error handling
- ✅ Beautiful, responsive design