Preguntas frecuentes
¿Aceptáis patrocinadores?
Sí, claro que sí - y nos encantaría contar con tu apoyo.
Los patrocinios mantienen vivo el proyecto y nos permiten lanzar actualizaciones, correcciones y nuevas funcionalidades para toda la gente que usa Stardrive.
Puedes apoyar el proyecto desde el botón de GitHub Sponsors en el repositorio.
Cada estrella, cada vez que lo compartes y cada patrocinador marcan una diferencia real - gracias por mantener vivo el open source.
¿Cómo empiezo?
Ejecuta
npm create stardrive@latesty sigue las indicaciones.Como alternativa, clona o haz fork del repositorio directamente y ejecuta
npm install.Arranca el servidor de desarrollo con
npm run dev.A partir de ahí, ajusta
theme.config.tspara que coincida con tu marca, sustituye los favicons y las imágenes sociales en/publicy edita las colecciones de contenido en/src/contentsegún tu proyecto.Si usas un asistente de programación con IA, apúntalo al repositorio y al archivo
AGENTS.md- Stardrive está pensado para que los LLMs lo entiendan y lo amplíen desde el primer momento.Echa un vistazo a la sección de documentación si quieres una guía más detallada sobre configuración, estructura y despliegue.
¿Debería abandonar React?
No, y tampoco tienes que hacerlo.
Astro no es un sustituto de React. Es la capa que lo envuelve. Puedes seguir usando componentes React dentro de páginas Astro siempre que necesites interactividad real, y Astro solo enviará el JavaScript que realmente haga falta.
Lo mismo aplica a Vue, Svelte y Solid: puedes combinarlos dentro del mismo proyecto.
Usa Astro para la estructura, el contenido y la base de rendimiento. Usa React (o el framework que prefieras) para las partes verdaderamente interactivas. Lo mejor de ambos mundos.
¿Es realmente gratis?
Sí, este boilerplate es completamente gratuito.
Es un proyecto de código abierto bajo la licencia MIT.
Para apoyarnos y asegurarte de que seguimos avanzando, puedes donar o patrocinar el proyecto, dejar una buena reseña en algún sitio y/o echar un vistazo a nuestros patrocinadores actuales.
¿Por qué Astro?
Astro es, a día de hoy, uno de los frameworks frontend con mejor rendimiento y más estables, y a la vez más flexibles que existen.
Por defecto no envía nada de JavaScript, lo que significa que tu sitio se mantiene súper rápido, accesible y SEO-friendly sin esfuerzo adicional.
Además, Astro te permite combinar componentes de React, Vue, Svelte o Solid, así que nunca estás atado a una tecnología y puedes usar la herramienta adecuada para cada caso.
Para un sitio orientado al contenido que necesita ser rápido, estable y fácil de ampliar, Astro es difícil de superar.
¿Por qué LLM-friendly?
Los LLMs y los asistentes de programación ya forman parte de casi cualquier flujo de trabajo de desarrollo - y funcionan mejor sobre código y contenido que sigue convenciones claras y predecibles.
Stardrive está estructurado exactamente así. Buenos defaults para SEO, accesibilidad, seguridad y metadatos ya están en su sitio, de modo que un agente de IA puede centrarse en construir funcionalidades en lugar de reinventar lo básico.
También hemos preparado todos los archivos markdown de guía para que sean fáciles de consultar. Los agentes de programación suelen detectarlos automáticamente.
Además, se generan automáticamente los archivos
llms.txtyllms-full.txt, para que los asistentes externos tengan una vista limpia y legible por máquinas de tu sitio.El resultado: iteración más rápida con agentes de IA, menos regresiones y sitios que se mantienen sólidos incluso cuando la mayor parte del código la escribe un modelo.
¿Puedo construir un SaaS con esto?
Sí, Stardrive es un excelente punto de partida para la parte pública de un producto SaaS.
Web de marketing, página de precios, blog, documentación, FAQ, directorio de integraciones y flujo de registro ya están listos y preparados para personalizarlos.
Para el producto en sí - autenticación, facturación, la propia aplicación, la base de datos - querrás un servicio backend dedicado. Stardrive habla con él vía APIs, mientras que la capa de marketing se mantiene rápida, estable y SEO-friendly.
Para la aplicación en sí, puede ser más sencillo construirla con otro framework más orientado a aplicaciones de página única puras. Astro tira más por la manera tradicional de construir sitios. Eso no encaja con todas las necesidades. Pero incluso en ese caso, seguiría siendo una buena elección para tu página de marketing.
Piénsalo como la puerta de entrada de tu SaaS: optimizada para conversión, contenido y búsqueda, mientras tu backend real se encarga del trabajo pesado.
¿Puedo construir una app dinámica con esto?
Sí y no, depende de a qué te refieras con “dinámica”.
Astro es un framework frontend. Se ejecuta del lado del cliente y, opcionalmente, con renderizado del lado del servidor bajo demanda y middleware por encima. Eso cubre muchos casos dinámicos: formularios, búsqueda, filtros, componentes de UI interactivos, páginas personalizadas, etc.
Incluso puedes incluir componentes escritos en React, Vue o Svelte con las llamadas “Dynamic Islands”.
Lo que no es, es un backend. Cualquier cosa que implique datos sensibles, lógica de negocio autenticada o una base de datos tiene que vivir en un servicio backend real con el que Stardrive se comunique vía API.
Así que: UI dinámica, contenido dinámico, renderizado dinámico, sí. App full-stack con base de datos y autenticación en el mismo proyecto, no de forma autónoma, y eso es a propósito.
¿Tengo que alojarlo en Cloudflare?
No, puedes alojar Stardrive donde quieras.
Recomendamos Cloudflare porque Astro y Stardrive están optimizados para su plataforma Workers, y el
wrangler.jsoncque incluimos junto con el script de purga de caché hacen que esa configuración sea especialmente sencilla.Como Astro es un framework frontend que compila a assets estáticos (con renderizado del lado del servidor bajo demanda opcional), puedes desplegar en Vercel, Netlify, Cloudflare, GitHub Pages, tu propio servidor o cualquier otro host estático.
Si cambias de host, simplemente quita las partes específicas de Cloudflare - el resto del boilerplate seguirá funcionando tal cual.
¿Tengo que ser desarrollador?
No necesariamente, pero entender cómo funciona una web a grandes rasgos ayuda bastante.
Stardrive está construido para que un asistente de programación con IA pueda hacer la mayor parte del trabajo pesado. Si sabes describir lo que quieres y revisar los cambios que hace un agente, puedes llegar muy lejos sin escribir código tú mismo.
Dicho esto, cosas como desplegar en Cloudflare, editar archivos de configuración o depurar un error de build inesperado serán mucho más fluidas si tú (o alguien de tu equipo) os sentís cómodos con lo básico de Git, Node.js y la línea de comandos.
En resumen: es un boilerplate de nivel desarrollador, lo bastante amigable para que alguien sin ese perfil pueda trabajar con un asistente de IA. ¡Pero no es una herramienta no-code!
Cómo actualizo
Debido a su carácter de plantilla, actualizar un proyecto Stardrive a la última versión de Stardrive puede ser un desafío.
Puedes actualizarlo incorporando la última versión desde el repositorio de GitHub (mediante
git pull).Sin embargo, ten en cuenta que, según la cantidad de cambios que hayas realizado, puedes encontrarte fácilmente con conflictos que pueden bloquear este proceso por completo.
En ese caso, tendrías que adaptar el código manualmente, comparando los cambios actuales con tu versión y actualizando los archivos uno por uno. También puedes encomendar esta tarea a un agente de codificación con IA, que la realizará por ti.
En la mayoría de los casos, no necesitas actualizar necesariamente la versión de Stardrive, sino simplemente el paquete subyacente de Astro.
Ejecuta
npx @astrojs/upgradepara hacerlo. Ten en cuenta que esto también puede implicar algunas tareas manuales. Echa un vistazo a la documentación oficial de Astro y, sobre todo, a los changelogs y guías de migración.Nota: La versión local de Stardrive está fijada en el
package.jsonbajo la clavestardriveVersion. Al comprobar si hay cambios, compara las notas de versión en el repositorio de GitHub con el estado de tu versión local para ver qué ha cambiado desde entonces.He encontrado un problema
Gracias por detectarlo - por favor repórtalo para que podamos arreglarlo.
Lo más rápido es abrir un reporte de bug en nuestro issue tracker de GitHub. Incluye los pasos para reproducirlo, lo que esperabas y lo que pasó en realidad. Un fragmento de código mínimo o una captura ayudan mucho.
Si no estás seguro de si es un bug o un comportamiento intencionado, el tablón de discusiones es un buen sitio para preguntar primero.
Los pull requests con un fix siempre son bienvenidos - revisa las guías de contribución antes de empezar.
Tengo una propuesta de funcionalidad
Genial - nos encanta escuchar qué haría a Stardrive más útil.
Abre una propuesta de funcionalidad en nuestro issue tracker de GitHub y describe el caso de uso, el problema que resuelve e, idealmente, una idea aproximada de cómo podría funcionar.
Para ideas más amplias o discusiones abiertas, el tablón de discusiones es el mejor sitio.
Si quieres aportar la funcionalidad tú mismo, mejor todavía - echa un vistazo a las guías de contribución y abre un pull request.
Ninguna pregunta coincide con tu búsqueda.
