Fuente: handbook/ en el repositorio. Cada bloque de código compila: el CI corre ray check sobre cada uno.
Más ejemplos
Las apps de este handbook cubren los casos más comunes, cada una explicada paso a paso. La organización ray-language publica más apps escritas en raylang, con su código completo, para otros casos de uso. Son un buen punto de partida cuando lo que quieres construir no está en el handbook: busca la más parecida, clónala y cámbiala.
Por caso de uso
| Caso de uso | Apps |
|---|---|
| Escritorio y móvil | ray808 (caja de ritmos con React para escritorio, iOS y Android), raydesk (gestor de tareas), raynote (bloc de notas con menús y diálogos nativos), rayplay (reproductor de audio en segundo plano), raystage (tipos de ventana) |
| Servidores y redes | raygate (API gateway), raywatch (monitor de servicios con panel SSE), raystream (servidor de medios), rayq (cola de mensajes con WAL), raykv (servidor compatible con Redis), raybot (bot por WebSocket), raymail (cliente SMTP), rayrelay (relay) |
| Sistemas distribuidos | raymart (comercio electrónico con microservicios, gateway, cola y cuatro bases de datos), raycall (microservicios con RPC y trazas) |
| Seguridad y P2P | msg (chat P2P cifrado), takeit (transferencia de archivos cifrada), raypass (bóveda de secretos), raysync (sincronización cifrada) |
| Web | store (tienda con frontend Astro y backend en raylang), raysite (generador de sitios estáticos) |
| Terminal | raytop (visor de procesos), raylogs (analizador de logs), raytetris, rallyx y 1942 (juegos a 30 fps) |
raymart es el ejemplo más completo: un comercio electrónico distribuido con
cuatro APIs de arquitectura hexagonal (productos, carrito, pedidos y pagos), cada una con su base
de datos (PostgreSQL, MySQL, MongoDB y raykv), detrás de raygate, comunicadas por rpc y gRPC y
coordinadas con la cola de rayq. Corre como binarios nativos con docker compose, e incluye
pruebas de punta a punta, de caos y de carga. Es la referencia para ver cómo encajan varias de
estas apps en un sistema real.
Los paquetes que usan están en el
índice de paquetes, y se buscan con ray search.
Después de cada capítulo
Cada capítulo del handbook tiene apps que llevan la misma idea más lejos:
| Si acabas de leer | Mira después | Qué añaden |
|---|---|---|
| App móvil y multiplataforma | ray808, rayplay, raydesk | audio en tiempo real y en segundo plano, y una app con más pantallas |
| Ventanas a fondo | raynote, raystage | un editor con documentos de verdad y todos los tipos de ventana |
| Sitio con plantillas y con React | store, raysite | una tienda con frontend aparte y un generador de sitios |
| API web | raygate, raycall, raymart | un gateway, trazas entre servicios y un sistema entero |
| Herramienta de terminal | raytop, raylogs, raytetris | interfaces de terminal a pantalla completa |
| Rendimiento | rayq, raykv, raystream | servidores medidos bajo carga |
Empezar desde una
git clone https://github.com/ray-language/raydesk && cd raydesk
ray fetch # descarga las dependencias del ray.toml a .ray-deps/
ray test
ray dev
Cada repositorio trae un README que dice qué cubre y cómo se ejecuta. Para convertirla en tu
proyecto, cambia name en [package] y name e id en [app], y borra lo que no necesites:
el compilador señala cada sitio que dependía de lo borrado.
Para cualquier función, la referencia tiene su firma, y el manual explica el lenguaje en detalle. La portada reúne todos los capítulos.