Add the scheduled tasks guide, environment variable overrides, the [mail] and [cron] references, CSRF protection without tokens, flash messages after redirects and the username policies of pagetop-user. Update the framework comparison with Poem and Topcoat.
9 KiB
PageTop frente a otros frameworks
Rust tiene muy buenos frameworks web, y es justo preguntarse por qué elegir uno u otro. Esta página compara PageTop con los más conocidos, con sus puntos fuertes y también con lo que a PageTop todavía le falta.
A grandes rasgos hay dos familias. Los modulares (Actix Web, Axum, Poem) te dan las piezas básicas para atender peticiones y te dejan elegir el resto: base de datos, plantillas, usuarios. Los completos (Rocket en parte, Loco, Cot, Topcoat) traen de serie muchas de esas piezas y unas convenciones para encajarlas. PageTop está en la segunda familia, con un matiz: lo que trae lo organiza en extensiones, componentes y temas, y casi todo es opcional.
Ten en cuenta también la madurez: PageTop sigue en versiones 0.x, su API todavía cambia entre versiones y su comunidad es más pequeña que la de la mayoría de los frameworks de esta página.
Tabla comparativa
| PageTop | Rocket | Poem | Loco | Cot | Topcoat | |
|---|---|---|---|---|---|---|
| Enfoque | Completo, por extensiones | Completo en parte | Modular, con OpenAPI | Completo (como Rails) | Completo (como Django) | Completo, interfaz reactiva |
| Base | Axum | Hyper y Tokio | Hyper y Tokio | Axum | Axum | Hyper y Tokio |
| HTML | html! con componentes y temas |
Tera, Handlebars o MiniJinja | A tu elección | Tera (u otro motor) | Askama (u otro motor) | view! con componentes |
| Interactividad | HTMX (extensión) | A tu elección | A tu elección | HTMX en sus generadores | A tu elección | Reactividad propia; también HTMX, Alpine AJAX o Datastar |
| Base de datos | SeaORM (extensión) | Varias, con su integración | A tu elección | SeaORM | ORM propio | Toasty, recomendado |
| Migraciones | Escritas en Rust, aplicadas al arrancar | Herramientas externas | Herramientas externas | Generadas con su CLI | Generadas a partir de los modelos | Generadas a partir de los modelos (Toasty) |
| Usuarios y permisos | Extensión (roles y permisos); CSRF en el núcleo | No | No (sesiones y CSRF) | Autenticación (JWT y claves de API) | Autenticación | Sesiones; autenticación prevista |
| Panel de administración | Extensible, con formularios de ajustes | No | No | No | Generado a partir de los modelos | No |
| Traducciones | Fluent, de serie | No | Fluent, opcional | Fluent, en su plantilla de proyecto | No | Fluent |
| Tareas en segundo plano y correo | Tareas programadas y correo con cola persistente (extensiones); sin cola de trabajos genérica | No | No | Colas, tareas programadas y correo | Correo y caché | Correo; tareas en segundo plano previstas |
PageTop frente a Rocket
Rocket es conocido por lo agradable que resulta escribir rutas con sus macros, por sus guardas de petición y por llevar la seguridad de tipos muy lejos. Trae de serie plantillas, cookies privadas, WebSocket, perfiles de configuración, pruebas e integración con varias bases de datos.
- Elige Rocket si te gusta su estilo de API y prefieres montar tú los usuarios, los permisos y la interfaz sobre esas piezas.
- Elige PageTop si quieres que esas piezas vengan resueltas: usuarios y permisos, panel de administración, temas y traducciones.
PageTop frente a Poem
Poem es un framework modular, como Axum o Actix Web, pero con
muchas piezas opcionales que se activan por features (sesiones, CSRF, WebSocket, traducciones con
Fluent...). Destaca por poem-openapi, que genera la especificación OpenAPI a partir de los tipos
de la API, y por su soporte para gRPC.
- Elige Poem si construyes una API y quieres la documentación OpenAPI generada de serie, con Swagger UI u otros visores, o quieres servir también gRPC con el mismo framework.
- Elige PageTop si vas a generar páginas: Poem no trae componentes, temas, usuarios ni panel de administración, y la interfaz queda en tus manos.
PageTop frente a Loco
Loco se presenta como «Rust on Rails» y como el framework para quien trabaja en solitario: convenciones fuertes, una CLI que genera código y muchas piezas incluidas, también sobre Axum y SeaORM.
- Elige Loco si te gusta la filosofía de Rails, quieres generadores de código, o necesitas ya colas de trabajos genéricas que sobrevivan a un reinicio (en la base de datos o en Redis), que PageTop todavía no tiene. Las tareas programadas y el correo sí los tiene PageTop, con sus extensiones, y el correo puede guardarse en una cola persistente.
- Elige PageTop si tu aplicación es sobre todo interfaz: los componentes tipados y los temas que pueden cambiar cualquier componente no tienen equivalente en Loco, que construye la interfaz con plantillas (sus generadores sí pueden crear vistas con HTMX).
PageTop frente a summer-rs
summer-rs (antes spring-rs) se inspira en Spring Boot: un núcleo pequeño de plugins que integran piezas del ecosistema (Axum, SQLx, SeaORM, Redis, correo con lettre, tareas programadas, autenticación con Sa-Token, OpenTelemetry, gRPC...), configurados en TOML y con inyección de dependencias en tiempo de compilación.
- Elige summer-rs si construyes servicios o APIs y quieres tener ya integrados la caché, las colas o la observabilidad.
- Elige PageTop si lo que construyes son páginas: summer-rs no trae plantillas, componentes, temas ni traducciones. La idea de los plugins es muy parecida a la de las extensiones; donde summer-rs inyecta componentes, PageTop guarda los servicios en estáticos (ve Compartir un servicio entre rutas).
PageTop frente a Cot
Cot toma la filosofía de Django: un ORM propio que genera las migraciones a partir de los modelos y un panel de administración que se construye solo.
- Elige Cot si te gusta Django y quieres un panel de administración con altas, bajas y modificaciones de tus modelos sin escribir nada, o una API JSON con su documentación OpenAPI y Swagger UI generadas.
- Elige PageTop si prefieres SeaORM, quieres construir la interfaz con componentes y temas en lugar de plantillas, o necesitas traducciones. El panel de PageTop no genera páginas a partir de los modelos, pero cada extensión le añade las suyas, con sus permisos (ve Añadir páginas al panel de administración).
PageTop frente a Topcoat
Topcoat, del proyecto Tokio (lo firman Carl
Lerche, creador de Tokio, y Julien Scholz), es el más parecido a PageTop en la forma de construir la
interfaz: todo se renderiza en el servidor, con páginas y componentes escritos en Rust (#[page],
#[component] y la macro view!). Añade su propio sistema de reactividad, con señales cuyo código
se compila a JavaScript y fragmentos de la página que se vuelven a renderizar en el servidor, y
también se integra con HTMX, Alpine AJAX o Datastar. Es muy reciente: se presentó en julio de 2026
y, como PageTop, avisa de que su API cambiará.
- Elige Topcoat si quieres reactividad en el navegador sin escribir JavaScript ni compilar a WebAssembly, o su biblioteca de componentes con Tailwind.
- Elige PageTop si necesitas ya usuarios y permisos, panel de administración o tareas programadas, que en Topcoat todavía no existen o están en su hoja de ruta, o temas capaces de cambiar el aspecto de cualquier componente sin tocar la aplicación.
¿Y Axum o Actix Web?
No están en la tabla porque casi todas sus filas dirían «A tu elección» o «No»: son la base sobre la que se construye una aplicación, no la aplicación hecha. PageTop está construido sobre Axum, así que comparten rutas, extractores y respuestas, y lo que sabes de Axum lo puedes usar en PageTop (lo cuenta Si vienes de Axum). Actix Web es maduro y uno de los más rápidos que existen, aunque Rust y Axum ya dan un rendimiento de sobra para la inmensa mayoría de aplicaciones de gestión. Son buena elección si quieres controlar cada pieza, construyes una API o un microservicio sin interfaz, o ya tienes código sobre alguno de ellos. Si vas a generar páginas, PageTop te ahorra juntar plantillas, traducciones, recursos estáticos, configuración y extensiones, y sigues teniendo Axum debajo cuando lo necesites.
¿Y Leptos o Dioxus?
Leptos y Dioxus son frameworks de pila completa con reactividad fina: la interfaz se compila a WebAssembly y se ejecuta en el navegador, y puede renderizarse antes en el servidor e hidratarse después. Dioxus, además, lleva la misma aplicación al escritorio y al móvil. Es el modelo contrario al de PageTop: aquí la interfaz vive en el servidor y HTMX sólo intercambia fragmentos de HTML. Si tu aplicación necesita mucha lógica en el navegador, funcionar sin conexión o ejecutarse también fuera de él, mira hacia ellos (lo explica también Por qué PageTop).
Siguiente
- Por qué PageTop: las ideas detrás del diseño.
- Si vienes de Axum: lo que ya sabes y lo que cambia.
- HTML por la red: por qué HTMX.