Joss Documentation

This documentation describes the behavior of the current code. It is separated in learning, guides, reference and internals so that a new person can move forward in order and an experienced person finds concrete rules.

Languages

• Español (canonical source)
• English: this directory.
• Português

All 46 documents use the same filename in every language, so relative links work consistently. After editing the Spanish source, run go run ./tools/docsi18n -translate -sync to update translations and mirror the web copy; go run ./tools/docsi18n -check detects missing files, stale translations, broken links or differences with JosSecurity.

Learn Joss (Guided route for beginners)

If you’ve never programmed or are learning Joss for the first time, read this walkthrough in order. Each page introduces concepts with pedagogical explanations, step-by-step visual examples, and quick cheat sheets before delving into advanced technical aspects.

1. First steps: from a file to your first interactive program with cin
2. Fundamental values, variables and operations
3. Flow control and decision making
4. Functions, scope, closures and references
5. Arrays, maps and text
6. Types, inference and conversions
7. Classes, objects and inheritance
8. Errors and exceptions
9. Async, Future, channels and concurrency
10. Full console project with JSON persistence
11. Complete web project with native MVC

The glossary explains programming and Joss terms without requiring that you already know another language.

Language and tools reference

• Syntax, tokens and precedence
• EBNF grammar and AST nodes
• Functions, recursion and types
• Diagnostics and analyzer
• Global functions
• Native classes and services
• Generated native catalog
• CLI, formatter, linter and tests
• Mobile support: Android and iOS
• VS Code Extension
• State and limits

Create applications

• Project structure and configuration
• Organization without imports and plugins
• Web: server, HTTP/controllers, middleware, views, assets and WebSockets
• Data: models/GranDB, Schema Builder and migrations
• Application: authentication and SEO/sitemap

Internals and maintenance

• Language architecture
• Contribution Guide- Documentation audit
• Joss Language Audit 2026
• GranDB ORM Audit 2026
• Technical audit of 2026
• Runtime Optimization Audit
• Historical news 3.6.7

Historical documents preserve context and can describe the state of your date. In the event of a difference, implementation, testing and Implementation status.