Arranca tu entorno
Instala el frontend, configura una identidad de integrador y conoce las comprobaciones del proyecto.
Esta guía describe el checkout 2aec1b16cc01 de pimia-web-shadcn.
Necesitas acceso al repositorio, un tenant de desarrollo y un client OAuth
autorizado para ese tenant. Que una pantalla exista en el frontend no implica
que un client de integrador tenga sus scopes.
Stack documentado
| Pieza | Declaración del proyecto |
|---|---|
| Next.js | 16.3.0 |
| React | 19.2.8 |
| TypeScript | ^5 |
| Tailwind CSS | ^4 |
| shadcn | Preset radix-nova, base neutral, Radix UI |
| Animación | tw-animate-css ^1.4.0 |
| Datos | TanStack React Query ^5.101.4 |
| SDK servidor | @pimia/sdk ^0.21.0 |
| Gestor de paquetes | pnpm 10.6.5 |
Los rangos son los de package.json; el lockfile fija la instalación efectiva.
Usa una versión de Node compatible con el Next.js instalado y con el SDK.
Instalación
Desde tu checkout:
pnpm install --frozen-lockfile
cp .env.example .env.localCada checkout debe instalar sus dependencias. No enlaces el node_modules de
otro checkout. Lee AGENTS.md y los manuales de la versión instalada en
node_modules/next/dist/docs/ antes de cambiar código de Next.js.
Configuración de la aplicación
| Variable | Propósito |
|---|---|
| PIMIA_BASE_URL | Patrón de instancias, con el marcador {tenant} en el subdominio |
| PIMIA_CLIENT_ID | Identificador del client de esta aplicación |
| PIMIA_CLIENT_SECRET | Secreto del client confidencial; solo servidor |
| PIMIA_REDIRECT_URI | Callback idéntico al registrado, incluido el puerto |
| PIMIA_TOKENS_DB | SQLite absoluto fuera del repo, único para esta identidad |
| PIMIA_PUBLIC_URL | Origen público del frontend, cuando corresponde |
| PIMIA_COOKIE_SECURE | Ajuste de cookie cuando el despliegue lo requiere |
.env.example explica también las variables opcionales de scopes, login y correo.
No copies credenciales ni el store de tokens de otro despliegue. En este
workspace el store existente se comparte entre sus checkouts; cambiar de client
requiere otro store, no reutilizar sus grants.
Ejecuta una sola instancia por store. Dos servidores que refrescan el mismo token pueden revocar el grant. El frontend de integrador no debe configurarse como primera parte para conseguir pantallas adicionales.
Primera ejecución
pnpm devAbre el puerto indicado por el servidor. Debe coincidir con el callback registrado. La entrada informa de configuración incompleta; al conectar se realiza OAuth. La contraseña y los tokens no se incorporan al código de las vistas.
Comprobación antes de compartir cambios
pnpm check
pnpm buildcheck ejecuta guards de dependencias, fronteras, puente, rótulos, selects,
copy, tamaño de archivos y tipografía, seguidos de lint, tipos y tests.
build comprueba además el empaquetado de Next.js. No uses pnpm portar para
traer vistas antiguas del escritorio: el régimen de porte está detenido.