Empieza
Instalar Agpiko
El cliente solo debe dar lo que no se puede inventar solo: dominio, un servidor con Node, y un admin.
CLI
El camino fácil es un comando. Descarga el paquete firmado, comprueba el servidor y deja el sitio listo. npx create-agpiko ./mi-sitio Te pedirá dominio, email y contraseña (o usa --yes). Luego: admin en /admin/login. Actualizaciones: Buscar → Aplicar. El paquete aún no está en el registro npm público. Mientras tanto, desde el árbol de origin: cd cli && npm run build && node dist/index.js create ./mi-sitio.
Camino fácil
Agpiko no se mete dentro de WordPress ni de un hosting solo PHP. Es una app Node con su panel. 1. Tienes un dominio (o uno que te den). 2. Tienes un VPS Linux con Node 22.13+ (o nos dejas instalarlo nosotros). 3. Corres la CLI (arriba). Entras a /admin/login. 4. Las versiones nuevas: panel → Actualizaciones → Buscar → Aplicar.
En tu PC
Para probar. Tres cosas no se pueden saltar: Node, un email/contraseña de admin, y arrancar. 1. Instala Node.js 22.13 o más nuevo. 2. Abre el paquete. En kernel/ copia .env.example a .env.local y pon solo email y contraseña de admin. 3. Ejecuta: npm install npm run db:seed npm run dev Entra en la URL que imprime Next, luego /admin/login.
En un servidor
Lo mínimo que el cliente (o su proveedor) tiene que tener listo antes: • DNS apuntando al VPS. • Sitio en el panel (CloudPanel u otro) con TLS. • Usuario Linux del sitio y un puerto libre. Después, un solo script (ops) hace el resto: descomprime, escribe .env.local, instala, compila, crea la base y arranca PM2. El proxy del panel debe apuntar a ese puerto. Si lo haces a mano (sin script), desde kernel/: npm install npm run build npm run db:seed pm2 start ./node_modules/next/dist/bin/next --name agpiko -- start -p 3008 pm2 save Usa el mismo puerto en PM2 y en el proxy. El canal y la clave pública ya van con valores por defecto del instalador; no los inventes. Entra en https://tu-dominio/admin/login.
Después
No vuelvas a subir código a mano. 1. Panel → Actualizaciones. 2. Buscar. 3. Aplicar. Eso reemplaza kernel/. Conserva site/, data/ y .env.local.
Qué pedimos y por qué
Dominio / DNS — Sí. Es suyo. Nosotros no podemos apuntarlo sin acceso. TLS en el panel — Sí, o lo hace el proveedor. No vive dentro de Agpiko. Servidor con Node — Sí, o hosting gestionado por Agpiko. No corre en PHP solo. Email y contraseña admin — Sí (o se genera y se la enviamos). Canal y clave pública — No. Van fijos en el instalador. npm install / build / seed / PM2 — No. Los hace el script. Editar nginx a mano — No. El panel apunta el proxy al puerto. Elegir puerto — No, si el instalador elige uno libre. Carpetas kernel/ site/ data/ — No. Salen del paquete. Solo debes saber que site/ es tu trabajo. Actualizar por SFTP — Nunca. Usa Buscar → Aplicar. Carpetas (referencia): install/ kernel/ app (una actualización la reemplaza) site/ tu proyecto (no se toca) data/ SQLite y claves (no va en git)
Look público
El sitio público lo pinta un theme en site/themes/<id>/, exportado en site/themes/index.ts. components/ piezas que se reutilizan sections/ un componente por bloque templates/ una plantilla por tipo de contenido index.ts theme.css templates/page es obligatoria. Es la plantilla del tipo page. La URL pública es /{slug}. Otra forma de la misma pieza, sin quitar la actual: sections/Hero.tsx sections/variations/Hero/Compact.tsx La carpeta se llama como el archivo. El archivo se llama como la variación. Quien puede editar páginas ve tres puntos al pasar el cursor, en la esquina de esa pieza, y elige ahí. Opciones: el componente exporta componentSettings. scope page guarda la opción en ese bloque. scope site la guarda para todo el sitio. variationScope = "site" hace lo mismo con la variación de archivo. Esas opciones salen en el mismo menú. El componente recibe settings ya resuelto. Texto: renderText pinta la etiqueta. Quien edita ve un lápiz al pasar el cursor. El clic hace editable esa misma etiqueta. Solo se guarda el idioma de la página abierta. El otro idioma no se reemplaza.
Siguiente paso
Con el sitio instalado, crea páginas en el panel y publícalas.
Ir al inicio