Syntax Reference

Let’s dive in!

Comments

Keep your configs documented with single-line comments:

// This is a comment
name = João  // Inline comment
age = 20

Pro Tip: Use comments to explain why a configuration exists, not just what it is.

Basic Assignments

The heart of JSSON: simple key-value pairs without the quote ceremony.

JSSON

name = João
age = 20
height = 1.75
admin = true

JSON Output

{
"name": "João",
"age": 20,
"height": 1.75,
"admin": true
}

When to use quotes:

• Use quotes when your value contains spaces: title = "Software Engineer"
• Skip quotes for simple identifiers: name = João

Data Types

JSSON supports all JSON data types with a cleaner syntax:

JSSON

// Strings (with or without quotes)
name = João
title = "Software Engineer"

// Numbers (integers and floats)
age = 25
price = 19.99

// Booleans
active = true
disabled = false

JSON Output

{
"name": "João",
"title": "Software Engineer",
"age": 25,
"price": 19.99,
"active": true,
"disabled": false
}

Objects

Nested objects are clean and intuitive — perfect for configuration files:

JSSON

user {
name = João
age = 20
admin = true
config {
  theme = dark
  notifications = true
}
}

JSON Output

{
"user": {
  "name": "João",
  "age": 20,
  "admin": true,
  "config": {
    "theme": "dark",
    "notifications": true
  }
}
}

Use Case: Perfect for app configs, server settings, and any hierarchical data.

Arrays

Mix any types freely — no quotes needed for simple values:

JSSON

numbers = [ 1, 2, 3, 4, 5 ]
colors = [ red, blue, green ]
mixed = [ João, 25, true, 1.75 ]

JSON Output

{
"numbers": [1, 2, 3, 4, 5],
"colors": ["red", "blue", "green"],
"mixed": ["João", 25, true, 1.75]
}

Power move: The map clause lets you transform each row. Add prefixes, compute values, or inject default fields — all in one place!

Expressions 🧮

Compute values instead of hardcoding them:

JSSON

price = 100
tax = 15
total = price + tax

discount = 20
final = total - discount

quantity = 5
itemPrice = 10
subtotal = quantity * itemPrice

JSON Output

{
"price": 100,
"tax": 15,
"total": 115,
"discount": 20,
"final": 95,
"quantity": 5,
"itemPrice": 10,
"subtotal": 50
}

Supported operators:

• Arithmetic: +, -, *, /, % (modulo)
• Grouping: ( ) for precedence

Use Case: Perfect for configs where values depend on each other — no need to manually calculate!

Member Access

Access object properties using dot notation:

JSSON

config {
host = localhost
port = 5432
}

connectionString = config.host + ":" + config.port

JSON Output

{
"config": {
  "host": "localhost",
  "port": 5432
},
"connectionString": "localhost:5432"
}

Pro Tip: Combine member access with expressions to build dynamic values from existing config!

Conditional Logic 🔀

JSSON supports powerful conditional logic with comparison operators and ternary expressions.

Comparison Operators

Compare values to get boolean results:

age = 20
isAdult = age >= 18      // true
canRentCar = age >= 25   // false
isTeenager = age >= 13
hasDiscount = age < 12

Supported operators: ==, !=, >, <, >=, <=

Ternary Operator

Choose between two values based on a condition:

status = age >= 18 ? "adult" : "minor"
access = role == "admin" ? "full" : "limited"

You can even nest them for complex logic:

salary = level == "senior" ? 120000 :
       level == "mid"    ? 80000  :
                           50000

Include Files 🧩

Split large configurations across multiple files for better organization:

database.jsson

database {
host = "localhost"
port = 5432
}

apiconfig.jsson

api {
url = "https://api.example.com"
timeout = 5000
}

include "database.jsson"

JSON Output

{
"api": {
  "url": "https://api.example.com",
  "timeout": 5000
},
"database": {
  "host": "localhost",
  "port": 5432
}}

Organization: Split by concern (database.jsson, api.jsson). Use main file to include others.

Expressions: Great for derived values. Reduces errors, makes configs self-documenting.

Ranges: Perfect for sequential data. Use step for custom increments.

Keywords Reference

Keyword	Description
template	Defines the structure for array items
map	Transforms template data with custom logic
include	Imports another JSSON file
step	Defines the increment in ranges
true / false	Boolean values

Operators

Operator	Description
=	Assignment
+	Addition / Concatenation
-	Subtraction
*	Multiplication
/	Division
%	Modulo (remainder)
== !=	Equality / Inequality
> <	Greater / Less than
>= <=	Greater/Less than or equal
? :	Ternary conditional
..	Range operator
.	Member access