create-admin-template

CLI para crear un nuevo proyecto con el template admin-template-core (Push-Orbita). Clona el repo del template, configura el proyecto e instala dependencias (incluido @Push-Orbita/admin-template-core).

Uso

npx create-admin-template <nombre-proyecto>

Ejemplo:

npx create-admin-template mi-app-admin
cd mi-app-admin
copy .env.example .env
# Editar .env con VITE_APP_API_URL, VITE_APP_API_URL_AUTH, VITE_APP_CLIENT_ID, VITE_APP_CLIENT_SECRET
npm run dev

Requisitos

• Node.js 16+
• Git instalado (el CLI clona el repo del template)
• Si el repo del template es privado: configurar acceso (token o SSH). Opcionalmente definir GH_TEMPLATE_REPO con la URL que incluya el token, por ejemplo:
  set GH_TEMPLATE_REPO=https://<TOKEN>@github.com/Push-Orbita/admin-template-core.git

Qué hace el CLI

1. Clona admin-template-core (solo última versión, sin historial).
2. Copia todo el contenido en la carpeta <nombre-proyecto> (sin .git).
3. Actualiza package.json con el nombre y descripción del proyecto.
4. Escribe .npmrc para que @Push-Orbita use GitHub Packages.
5. Opcionalmente ejecuta npm install (o yarn/pnpm) para instalar dependencias.

Publicar el CLI en npm

Este paquete se publica en npm (registro público) para que funcione npx create-admin-template. No usar GitHub Packages para el CLI.

Pasos para publicar

1. Cuenta en npm
   Crear cuenta en npmjs.com si no tenés. Si npm te pide 2FA, activala en “Account settings” → “Enable two-factor authentication”.

2. Loguearse en npm (una vez por máquina):

   npm login

   Te pedirá Username, Password, Email y (si tenés 2FA) un código OTP.

3. Desde la carpeta del CLI (cli-admin-template-core):

   cd path/to/cli-admin-template-core
   npm install
   npm publish --access public

   --access public es necesario para paquetes con nombre sin scope (como create-admin-template).

4. Si el nombre create-admin-template ya está tomado por otro usuario en npm, no podrás publicar con ese nombre. En ese caso, en package.json dejá "name": "cli-admin-template-core" y publicá igual; el comando será npx cli-admin-template-core <nombre-proyecto>.

5. Actualizar una versión ya publicada
   Cambiá version en package.json (ej. 2.0.1), luego:

   npm publish --access public

Después de publicar, cualquiera puede usar: npx create-admin-template mi-proyecto.

Licencia

MIT