Fuente: handbook/ en el repositorio. Cada bloque de código compila: el CI corre ray check sobre cada uno.

El handbook de raylang

Guías para construir cosas reales con raylang, de ray new a la app instalada o el servicio desplegado. Cada guía es un camino completo para un tipo de proyecto: no explica el lenguaje módulo a módulo (para eso están el manual y la referencia), sino qué piezas usar, en qué orden y por qué.

Las guías se encadenan: la libreta de notas que empieza como app móvil vuelve como app de escritorio, como API, como sitio con plantillas y como sitio con un frontend de React. Cada una guarda sus datos de una forma distinta, así que al terminar has usado toda la gama: el almacén std/kv, SQLite, Postgres, archivos y Redis.

Todo el código de estas páginas compila: el CI pasa ray check sobre cada bloque.

Capítulos

Empezar: instalar, el editor, un proyecto, el lenguaje en quince minutos, la concurrencia, trabajar con un asistente LLM y las herramientas.
App móvil para iOS y Android: una app de notas con frontend React + TypeScript y datos en std/kv, del proyecto al simulador, al emulador y a la recarga en caliente en el teléfono.
App multiplataforma: la misma app en macOS, Linux y Windows, con SQLite, menús y diálogos nativos, y una interfaz que se adapta a cada pantalla.
Ventanas a fondo: todo lo que std/ui da a una app de escritorio, sobre un editor de texto: el puente con la página, menús, diálogos, tipos de ventana y cambios sin guardar.
Sitio con plantillas: las notas como sitio renderizado en el servidor, con plantillas compiladas, formularios, Markdown y los datos en archivos.
API web: las notas como API JSON con el framework web, Postgres con un pool de conexiones, autenticación por token y apagado ordenado.
Sitio con frontend React: un frontend React embebido en el binario, una API JSON y las notas en Redis.
Herramienta de terminal: una herramienta de línea de comandos con opciones, entrada por tubería, salida para personas y para programas, y códigos de salida.
LLM y MCP: un asistente que escribe raylang verificado con ray mcp, un agente escrito en raylang con los paquetes llm, mcp y agent, y un servidor MCP propio.
Rendimiento: medir, perfilar con ray profile, arreglar el algoritmo, compilar a nativo y repartir el trabajo entre núcleos, con cifras medidas.
Distribuir: empaquetar y firmar para cada sistema, publicar en las tiendas móviles y actualizaciones automáticas firmadas en escritorio.
Más ejemplos: las apps de la organización ray-language, por caso de uso, para lo que no cubren los capítulos.

Para cualquier función, la referencia tiene su firma, y el manual explica el lenguaje en detalle.