Instalación
Dependencia git privada, transpilación y Tailwind en cuatro pasos.
La dependencia
"dependencies": {
"@fesa/components": "git+ssh://[email protected]/AdanSerrano/fesa-components.git#v0.5.2"
}Siempre pineada a un tag. Nunca a main: tú decides cuándo tu app sube de versión.
Peer dependencies que tu app ya debe tener: next ≥16, react ≥19.2, zustand ^5, sonner ^2.
Transpilación
const nextConfig: NextConfig = {
transpilePackages: ["@fesa/components"],
};La librería se distribuye como TSX crudo (sin build step): tu app la compila igual que su propio código.
Tailwind
@import "tailwindcss";
@source "../node_modules/@fesa/components/src";Sin esta línea Tailwind no genera las clases que usa la tabla y se ve "rota" (sin bordes ni espaciados).
Tokens de tema
La tabla toma sus colores de las variables del @theme de Tailwind v4 — las mismas que define shadcn: --color-background, --color-muted, --color-primary, --color-border… Si tu app ya usa shadcn, no hay nada que configurar: la tabla hereda tu tema, claro y oscuro.
Servidor de despliegue
El bun install del VPS necesita leer el repo privado. El VPS fesa.prod ya tiene su deploy
key; para otro servidor, genera una clave y agrégala en GitHub → fesa-datatable → Settings →
Deploy keys (read-only).
Actualizar de versión
# 1. Cambia el tag en package.json (#v0.5.0 → #v0.5.2)
# 2. Purga la resolución cacheada de bun:
grep -v '"@fesa/components"' bun.lock > bun.lock.tmp && mv bun.lock.tmp bun.lock
bun pm cache rm
rm -rf node_modules/@fesa
bun installPor qué la purga
bun cachea la resolución del commit por URL de git. Si solo cambias el tag, a veces reinstala el commit viejo. La purga garantiza que instala exactamente lo que el tag apunta.