VSS Programming Language VSS Core Team

cli compiler interpreter language programming-language scripting

Use this command to install VSS Programming Language:

winget install --id=VSS.VSS -e

VSS (Very Simple Syntax) is a beginner-friendly, dynamically typed scripting language with a clean, English-like syntax. Version 2.1 ships a complete standard library (math, string, file, json, http, time, random, system, database, crypto, network), a native bytecode VM with automatic reference counting, colored error diagnostics, and the grab module system. Full CLI: run, build, new, init, test, format, lint, docs, clean, doctor.

VSS (Very Simple Syntax) Language

VSS is a highly readable, human-centric programming language designed to eliminate syntax noise (no curly braces, semicolons, or parentheses) and deliver absolute simplicity for both system automation and web development.

This repository contains the complete VSS v1.0.0 implementation, including a compiler frontend, dynamic runtime with reference counting, a tree-walk interpreter, a live development web server, and official IDE support extensions.

Key Features

No Syntax Noise: No {} or ;. Indentation and simple keywords (when, repeat, finish) manage code blocks.
Dynamic Type System: Supports numbers, booleans, strings, lists, maps, and task closures.
Memory Safety (ARC): Automatic Reference Counting (ARC) handles garbage collection in C with zero memory leaks.
Error Handling (attempt/rescue): Native try-catch mechanism with named error variables.
Embedded Webpage Delimiters: Create Tailwind-powered responsive webpages natively using hi htmvss and bye htmvss.
Built-in Dev Server: Run vss --serve to compile and launch .htmvss pages with dynamic hot-reloading.

Getting Started

1. Requirements

Linux or WSL (Ubuntu/Debian)
GCC compiler and Make (build-essential)

2. Compilation

To build the VSS compiler executable:

cd vss
make

3. Running Examples

Run the built-in VSS programs:

./vss examples/hello.vss
./vss examples/conditions.vss
./vss examples/tasks.vss

Web Development in VSS

VSS has native support for compiling and serving web templates. Create a file named page.htmvss:

hi htmvss
    say "    <div class="bg-slate-800 p-8 rounded-2xl shadow-2xl text-center">"
    say "        <h1>Hello from VSS!</h1>"
    say "        <p>Rendered dynamically by the VSS Runtime.</p>"
    say "    </div>"
bye htmvss

Start the interactive dev server to automatically compile and launch it in your browser:

./vss --serve

When started, the dev server scans the current working directory for .htmvss files:

It looks for index.htmvss to serve as the default entry point.
If not found, it checks for main.htmvss.
If neither exists but exactly one .htmvss file exists, it is served automatically.
If multiple .htmvss files exist, it lists them and prompts you to select one.
If no .htmvss files are found, it prints a message and starts the server without opening the browser.

Editor Support (VS Code & Antigravity IDE)

The official extension provides syntax highlighting (including HTML inside VSS strings) and real-time error checking.

To install manually: Copy the vss-support directory to your extensions folder:

VS Code: ~/.vscode/extensions/
Antigravity IDE: ~/.antigravity-ide/extensions/