🚀SHASHX

Welcome to shashx

A lightweight, dynamically-typed interpreted language built for simplicity and learning.

Get Started

📖 What is shashx?

shashx is a beginner-friendly, custom-designed programming language aimed at demystifying how programming languages work under the hood. It is built with simplicity and clarity in mind — offering clean syntax, custom logic structures, and real-time execution through an interpreter model.

Developed by Shashwat Singh, shashx serves as both a personal project and a powerful educational tool that helps aspiring developers understand the core concepts behind language design.

Whether you're a curious developer or an enthusiast interested in compiler theory, shashx opens the doors to understanding what's behind every line of code you write — by letting you build and run your own.

✨ Features

  • ✅ Dynamically typed – no need to declare types
  • ⚡ Interpreted – executes directly without compilation
  • 🧼 Custom clean syntax – simple and intuitive commands
  • 🔁 Loop support – flp, wlp, dlp
  • 🧠 Conditionals – if, elf, el
  • 🖨️ Print statements with pf()
  • 🛠️ Built with JavaScript (Node.js)
  • 🖥️ CLI-based execution
  • 💻 VS Code syntax extension support

🔧 Under the Hood

shashx is built from scratch using JavaScript and follows a basic interpreter pattern. Here's how it works internally:

  • 📜 Lexer: Breaks your code into tokens (keywords, symbols, identifiers).
  • 🌳 Parser: Builds an Abstract Syntax Tree (AST) from tokens.
  • 🧠 Interpreter: Walks the AST and executes commands in real-time.
  • 📁 File Extension: Uses .sx for source code files.
  • 🧪 Minimal runtime: Everything runs via a lightweight runtime powered by Node.js.

This structure makes shashx simple, fast, and easy to extend!

📦 Installation

Install via NPM (Recommended)

  npm install -g shashx

Run a .sx File

  shashx hello.sx

💡 Example: hello.sx

hello.sx

  pf("Hello from shashx!");

Terminal Output

  Hello from shashx!

🧠 Syntax Guide

➕ Print Statement

pf("Hello, World!");

📦 Variable Declaration

@x = 10
@y = 20
pf(>x)
pf(>y)

➰ For Loop (flp)

flp @i = 0 to 3 {
  pf("flp i = " > i);
}

📝 Comment Line

~> This is a single-line comment

Use ~> to write single-line comments in shashx.

🔁 While Loop (wlp)

  @j = 0;
  wlp j < 2 {
    pf("wlp j = " > j);
    j = j + 1;
  }

🔁 Do-While Loop (dlp)

  @k = 0;
  dlp {
    pf("dlp k = " > k);
    k = k + 1;
  } wlp k < 2;

🔂 Conditional Statements

  @x = 10
  if x > 5
    pf("Greater than 5")
  elf x == 5
    pf("Equals 5")
  el
    pf("Less than 5")

🧩 VS Code Extension Support

Add syntax highlighting for shashx in your VS Code editor!

  • 🔤 Syntax highlighting
  • 🗂️ File recognition (.sx)
  • ✍️ Friendly editing experience
👉 Install Extension

🎨 Let's Dive

  ███████╗██╗  ██╗ █████╗ ███████╗██╗  ██╗██╗  ██╗
  ██╔════╝██║  ██║██╔══██╗██╔════╝██║ ██╔╝██║ ██╔╝
  ███████╗███████║███████║█████╗  █████╔╝ █████╔╝ 
  ╚════██║██╔══██║██╔══██║██╔══╝  ██╔═██╗ ██╔═██╗ 
  ███████║██║  ██║██║  ██║███████╗██║  ██╗██║  ██╗
  ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝

Install it Now!! shashx

📢 Contribution

Want to improve shashx? Whether it's fixing bugs, adding new features, or improving documentation — every contribution counts!

  • 🍴 Fork the repository
  • 🛠️ Make your changes
  • 📩 Open a pull request

Bug reports, feature ideas, and suggestions are always welcome. Let's build something great together!

🌟 Ready to Contribute?

Jump straight into the GitHub repository and start collaborating on the future of shashx.

🚀 Go to GitHub Repo

Don’t forget to ⭐ the repo if you find it useful!

📬 Contact

Hey there! 👋 I’m Shashwat Singh

A passionate developer, security enthusiast, and creator of the shashx language. I'm always open to interesting conversations and cool collaborations!

💻 JavaScript 🛡️ Cybersecurity 🌐 Web Dev 🧠 AI Projects 🛠️ CLI Tools
"Code is not just a skill, it's a superpower 💥"

📧 Email: singhshashwat521@gmail.com

🌐 GitHub: github.com/shashwat-singh-01

🔗 LinkedIn: linkedin.com/in/shashwat-singh-200495248