Documentación

DOC / 02 / INICIO

Estructura del proyecto

Entiende pliego.toml, el paquete del sitio, el cliente WASM opcional, los assets públicos y la propiedad de la salida.

En esta guíaEstructura del proyecto
Primeros pasosEstructura del proyectoReferencia del CLIBucle de desarrolloRouting y páginasVistas RustEventos y foldsSchemas y snapshotsSync verificado con HyphaeContenido tipadoRuntime del navegadorPropiedad del DOMAssets adaptativosConfianza de artefactosErrores y diagnósticosBuild y despliegueCrates y APILicenciamiento y políticas

El árbol predeterminado

text
my-app/
├── Cargo.toml
├── pliego.toml
├── README.md
├── LICENSE
├── assets/
│   ├── favicon.svg
│   ├── site.css
│   ├── site.webmanifest
│   └── robots.txt
└── src/
    └── main.rs

Un sitio puede permanecer como un paquete Rust o crecer hacia un workspace con un paquete nativo del sitio y un cliente de navegador cdylib separado. El manifest controla ese límite explícitamente.

pliego.toml

toml
[project]
id = "my-app"
name = "My App"
site_package = "my-app"
output = "target/site"

Las rutas generadas deben permanecer dentro del proyecto, usar nombres portables y evitar el árbol de fuentes. El pliego.toml más cercano define el proyecto activo para cada comando del CLI.

Paquetes de sitio y cliente

id
Una identidad portable estable que posee el linaje de artefactos
site_package
Un binario nativo que crea páginas completas y escribe el ledger de salida
client.package
Un cdylib opcional compilado a wasm32-unknown-unknown
client.bindgen_output
Glue JS/WASM generado y consumido por el paquete del sitio

La salida es un artefacto

target/site se reemplaza atómicamente después de un build exitoso. pliego.build.json vincula cada archivo emitido por ruta, tamaño y SHA-256; preview e inspect rechazan un ledger ausente o inválido.