Welcome to the Topaz Documentation!

This is We're thrilled to have you explore Topaz. Welcome to a new era of clarity and power in programming!

Our official guide to Topaz, a groundbreaking language engineered for extreme efficiency, unambiguous clarity, and seamless AI integration. Inspired by the developer-friendly philosophy of Ruby and built with a fresh, LISP-like S-expression syntax, Topaz is designed to empower both new and seasoned developers in the rapidly evolving world of technology.

Documentation in Other Languages

한국어 번역본 - Complete Korean translation
Русская версия - Complete Russian translation

What is Topaz?

Topaz (also known as Core Syntax Language, or CSL) is more than just a programming language; it's a forward-thinking ecosystem. It aims to redefine developer productivity, especially when working with AI-driven applications, embedded systems, and robotics.

By prioritizing a minimalist, machine-friendly S-expression syntax and strong static typing with powerful type inference, Topaz ensures your code is not only concise and elegant but also robust, predictable, and highly performant.

Example: Your First Topaz Program

Let's see how Topaz approaches the classic "Hello, World!":

;; main.tpz - A simple "Hello, World!" program in Topaz

;; Define a main process (function) that prints to the console.
;; Topaz uses S-expressions: (OPERATOR ARG1 ARG2 ...)
;; $ is used for definitions. λ creates an anonymous process.
($ main
  (λ () ;; A process that takes no arguments
    (io:print "Hello, Topaz World!") ;; print from the io module
  )
)

;; To execute the main process (this might be implicit for a 'main' process
;; or called explicitly, depending on the Topaz runtime environment):
;; (main)

This example showcases Topaz's S-expression syntax for defining a process (λ) and calling an operation (PRINT). The CodeBlock component (which renders this block) will soon feature full Topaz syntax highlighting!

Key Strengths of Topaz

AI-Centric by Design: Engineered from the ground up for optimal AI processing, generation, and collaboration.
Powerful S-Expression Syntax: Offers exceptional metaprogramming capabilities, structural clarity, and ease of parsing for both humans and machines once familiar.
Extreme Efficiency & Performance: Optimized for speed, minimal overhead, and resource-constrained environments.
Unambiguous & Explicit: Designed to reduce cognitive load, minimize side effects, and prevent common programming errors.
Ruby-Inspired Philosophy: Embraces developer happiness and expressiveness within its unique syntactic framework.

Next Steps

Ready to dive deeper?

Start your journey with our Getting Started guide to learn the basics and set up your environment (or look out for our online playground, coming soon!).
Explore the Language Reference for an in-depth understanding of Topaz syntax, data structures, and core concepts.
Learn about the broader vision of the Core Syntax Kernel and how Topaz plays a central role.