Taneship Free frente al starter kit oficial de React de Laravel
Los dos kits son gratuitos, con licencia MIT, y ofrecen las mismas funcionalidades sobre Laravel 13, Inertia 3 y React 19. Se diferencian en dónde vive el código de la autenticación, y en cuánta parte del código comprueba una herramienta. Esta página los compara archivo por archivo.
Comparación del 28 de septiembre de 2026: commit 717b8f5 del kit oficial, y rama main de Taneship Free.
Cuál elegir
Taneship Free
Elige Taneship Free si
- Quieres leer y modificar cada línea de la autenticación, sin ningún paquete entre tú y el código.
- Quieres el análisis estático al máximo desde el primer commit: Larastan nivel 10, sin baseline.
- Agentes de código escriben parte de tu código, y quieres que las herramientas rechacen lo que incumple una regla.
- Quieres que cada página se renderice en el servidor y se pruebe en un navegador.
- Te planteas Taneship Pro o Teams: Free es el código del que parten.
Starter kit oficial de React de Laravel
Elige el kit oficial si
- Quieres un kit mantenido por el equipo de Laravel y documentado en laravel.com.
- Prefieres una autenticación que se queda en un paquete: composer update trae las correcciones de Laravel Fortify.
- Quieres seleccionar las funcionalidades de autenticación cuando laravel new crea el proyecto.
- Trabajas con PHP 8.3 u 8.4.
- Quieres elegir entre varios diseños: barra lateral o cabecera, y tres diseños para las páginas de inicio de sesión.
La comparativa detallada
Siete áreas, del stack a la integración continua. Cada línea sale de los archivos de los dos repositorios.
Stack y creación del proyecto
Los cimientos son los mismos. Taneship fija versiones más recientes y pide un PHP más reciente. El kit oficial se instala con el instalador de Laravel y ofrece más diseños.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Framework | Laravel 13, Inertia 3, React 19 | Laravel 13, Inertia 3, React 19 |
| PHP | 8.5 | 8.3 o posterior |
| TypeScript | TypeScript 7 | TypeScript 5 |
| Herramientas | Vite+ 1: Vite, Vitest, Oxlint, Oxfmt | Vite+ 0.3: Vite, Oxlint, Oxfmt |
| Componentes | shadcn/ui sobre Base UI | shadcn/ui sobre Radix UI |
| Creación de un proyecto | Una plantilla de GitHub: gh repo create --template | El instalador de Laravel: laravel new |
| Quitar una funcionalidad | Borras su código | Una pregunta en la instalación quita las funcionalidades de autenticación que no seleccionas |
| Diseños | Un diseño de aplicación con barra lateral, un diseño de autenticación | Barra lateral o cabecera, y tres diseños de autenticación |
Código de la autenticación
Es la mayor diferencia. El kit oficial delega la autenticación en Laravel Fortify: las rutas, los controladores y la lógica viven en vendor/, y tu aplicación los configura con config/fortify.php y un service provider. Taneship no tiene Fortify: cada operación es una acción de tu aplicación, llamada por un controlador que puedes leer.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Dónde vive la lógica | app/Actions, una clase por operación: RegisterUser, VerifyEmail, ResetPassword | El paquete laravel/fortify, completado por dos clases en app/Actions/Fortify |
| Rutas | routes/identity.php, en tu aplicación | Registradas por el paquete |
| Controladores | app/Http/Controllers/Auth, solo con métodos de recurso | En el paquete |
| Cambiar un comportamiento | Modificas la acción | Con la configuración, los callbacks y los contratos de Fortify |
| Autenticación en dos pasos | Acciones de tu aplicación, sobre pragmarx/google2fa | Fortify |
| Passkeys | Acciones de tu aplicación, sobre web-auth/webauthn-lib y @simplewebauthn/browser | Fortify y @laravel/passkeys |
| Correcciones de seguridad | Las aplicas a mano desde las versiones de Taneship | composer update trae las correcciones de Fortify |
Análisis estático y reglas de código
Los dos kits usan Larastan y Pint. Taneship sube Larastan a su máximo, añade Rector y convierte sus convenciones en reglas que hacen fallar el build.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Nivel de Larastan | 10, el máximo | 7 |
| Baselines y comentarios de exclusión | Ninguno, y un test los rechaza | Ninguna regla |
| Refactorización automatizada | Rector, con las reglas de Laravel | Ninguna |
| Formato del PHP | Pint | Pint |
| Tipos estrictos y clases finales | Obligatorios en cada archivo, comprobados por un test | No obligatorios |
| Cobertura de tipos | 100 % obligatorio | No se mide |
| Lint de TypeScript | Oxlint con análisis de tipos: any, las aserciones no nulas y @ts-ignore son errores | Oxlint con análisis de tipos, y sus reglas por defecto |
| Hooks de Git | Corrigen los archivos preparados y comprueban el mensaje del commit | Ninguno |
Tests
El kit oficial incluye tests funcionales de sus páginas de autenticación y de ajustes. Taneship añade tests de arquitectura, tests en un navegador y umbrales de cobertura.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Framework | Pest 5 | PHPUnit 12 por defecto |
| Tests funcionales | Cada acción y cada ruta | Las páginas de autenticación y de ajustes |
| Tests de arquitectura | Capas, nombres, tipos estrictos, clases finales, código sin usar, claves de traducción | Ninguno |
| Tests en un navegador | Cada página en modo claro y en modo oscuro, y los recorridos críticos, con Playwright | Ninguno |
| Accesibilidad | axe analiza cada página: ningún problema, sea cual sea su nivel de impacto | No se prueba |
| Cobertura de tests | 90 % como mínimo, o el build falla | No se mide |
| Tests unitarios del front-end | Vitest | Ninguno |
| Bases de datos probadas | SQLite, PostgreSQL y MySQL | SQLite |
Renderizado, tema y textos de la interfaz
Los dos kits muestran páginas de React a través de Inertia. Taneship las renderiza en el servidor por defecto, guarda el tema en la cuenta, mantiene cada texto en un archivo de traducción y también se lee de derecha a izquierda.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Renderizado en el servidor | Activo por defecto: un solo build genera los bundles de cliente y de servidor, y los tests en un navegador comprueban que cada página se renderizó en el servidor | Opcional: un script build:ssr aparte genera el bundle de servidor |
| Tema | Guardado en la cuenta: sigue al usuario de un dispositivo a otro | Guardado en el navegador: una cookie y localStorage |
| Textos de la interfaz | En archivos de traducción, listos para otros idiomas | Escritos en los componentes, en inglés |
| Idiomas de derecha a izquierda | Listo: la dirección de la página sigue el idioma, los componentes usan clases CSS lógicas, y la navegación con el teclado y los menús siguen esa dirección | Sin preparar: los componentes usan clases de izquierda y derecha |
| Cabeceras de seguridad | Enviadas por un middleware de la aplicación | A tu cargo |
| Lighthouse | Al menos 95 en móvil en las páginas públicas, comprobado en CI | No se mide |
Agentes de código
Los dos kits funcionan con agentes de código. Taneship escribe sus reglas para ellos, y después deja que las herramientas rechacen lo que incumple alguna.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Convenciones | AGENTS.md: stack, estructura, nombres, tests y límites | Ningún archivo de convenciones en el repositorio |
| Laravel Boost | Incluido, por su servidor MCP | No está en el repositorio: el instalador de Laravel puede añadirlo |
| Qué frena una desviación | Larastan nivel 10, los tests de arquitectura y los umbrales de cobertura hacen fallar el build | Larastan nivel 7 y los tests funcionales |
Integración continua
Cada kit incluye sus workflows de GitHub Actions. El kit oficial tiene uno, que ejecuta el lint, las comprobaciones de tipos y los tests. Taneship tiene cuatro.
| Criterio | Taneship Free | Starter kit oficial de React de Laravel |
|---|---|---|
| Workflows | Cuatro: controles de calidad, Lighthouse, mensajes de commit, auditorías de dependencias | Uno: lint, comprobaciones de tipos y tests |
| Entorno | PHP 8.5 y Node.js 24 | PHP 8.3 y Node.js 22 |
| Dependencias | composer audit y npm audit en cada push, y cada semana | Dependabot, para las GitHub Actions |
| Mensajes de commit | Conventional Commits, comprobados en cada commit y en CI | Ninguna regla |
Un ejemplo: el registro
En el kit oficial, las rutas y el controlador de Fortify reciben la petición. Llaman a app/Actions/Fortify/CreateNewUser, una clase que implementa un contrato de Fortify: valida un array de datos y crea el usuario. Después, Fortify inicia la sesión del usuario y lo redirige.
En Taneship, routes/identity.php envía la petición a RegistrationController. RegisterUserRequest la valida y devuelve un objeto RegistrationData, la acción RegisterUser crea el usuario, y el controlador inicia su sesión. Cuatro archivos cortos, todos en tu aplicación.
app/Actions/RegisterUser.php
<?php
declare(strict_types=1);
namespace App\Actions;
use App\Data\RegistrationData;
use App\Models\User;
use Illuminate\Auth\Events\Registered;
final readonly class RegisterUser
{
public function handle(RegistrationData $registration): User
{
$user = User::query()->create([
'name' => $registration->name,
'email' => $registration->email,
'password' => $registration->password,
]);
event(new Registered($user));
return $user;
}
}Prueba los dos en cinco minutos
Ninguno de los dos kits necesita claves de terceros. Instálalos uno al lado del otro, y después lee su código.
gh repo create my-app --template taneship/taneship --private --clonecd my-appcomposer setupcomposer devlaravel new my-appcd my-appcomposer devPreguntas sobre esta comparativa
¿Es Taneship un fork del starter kit de React de Laravel?
No. Taneship Free está escrito desde cero. Reproduce las funcionalidades del kit oficial y comparte su stack: Laravel 13, Inertia 3, React 19, Wayfinder y shadcn/ui.
¿Tiene Taneship Free todas las funcionalidades del kit oficial?
Sí: registro, inicio de sesión, verificación del correo, restablecimiento de la contraseña, confirmación de la contraseña, autenticación en dos pasos, passkeys, perfil, cambio de contraseña, eliminación de la cuenta y elección del tema. Dos cosas se dejan fuera a propósito: los diseños alternativos, que son decisiones de presentación, y la pregunta del instalador sobre las funcionalidades. En Taneship, borras el código que no quieres.
¿Por qué Taneship no usa Laravel Fortify?
Fortify mantiene la lógica de la autenticación en un paquete y la dirige con configuración y callbacks. Taneship escribe la autenticación en acciones y controladores de tu aplicación, para que la leas y la modifiques como el resto de tu código. La contrapartida: aplicas a mano las correcciones de seguridad de las versiones de Taneship, mientras que composer update trae las de Fortify.
¿Admite el starter kit de React de Laravel el renderizado en el servidor?
Sí, como opción: su script build:ssr genera el bundle de servidor. En Taneship, el renderizado en el servidor está activo por defecto: el build estándar genera los dos bundles, y cada test en un navegador comprueba que la página se renderizó en el servidor.
¿Es Larastan nivel 10 más exigente que el nivel 7?
Pide más al código que escribes: los niveles 8 a 10 rechazan las llamadas sobre valores que pueden ser nulos, y las operaciones sobre valores de tipo desconocido. Taneship pasa el nivel 10 sin baseline: tu proyecto parte de cero errores, y cada error que encuentras señala una línea de tu propio código.
¿Cuál de los dos kits es mejor para los agentes de código?
Los dos funcionan con Claude Code, Codex, Cursor y los demás. Taneship da a los agentes convenciones escritas en AGENTS.md, y después comprueba lo que escriben: Larastan nivel 10, los tests de arquitectura, un umbral de cobertura del 90 % y los tests en un navegador rechazan el código que incumple una regla, lo escriba quien lo escriba.
¿Puedo pasar un proyecto del kit oficial a Taneship?
No de forma automática: los dos kits organizan su código de manera distinta, y Taneship no tiene instalador ni comando de actualización. Para un proyecto recién empezado, crea uno nuevo desde la plantilla de Taneship y mueve tu código a él. Para un proyecto más antiguo, toma lo que necesites: los controles de calidad, los tests de arquitectura y AGENTS.md se copian uno a uno.
¿Cuánto cuesta Taneship?
Taneship Free es gratuito y de código abierto, con licencia MIT, como el kit oficial. Taneship Pro y Taneship Teams, que añaden lo que un SaaS necesita para vender, son ediciones de pago, anunciadas como próximamente.
Lee los dos, y después decide
El kit oficial se instala con un comando, y Taneship Free es un repositorio público. El código es el mejor argumento de cada uno.