1. 1

    Instalar y arrancar

    Instala las dependencias, descarga PocketBase, crea el archivo de configuración y arranca el servidor.

    $ bun run setup
  2. 2

    Arranques posteriores

    Después de instalarlo, arranca el servidor con este comando.

    $ bun run dev

    Abre http://localhost:3000 y entra con el correo y la contraseña del archivo .env . Cambia esa contraseña antes de usar Planer con datos reales.

  3. 3

    Probar con un ejemplo

    Con el servidor en marcha, ejecútalo en otra terminal. Crea un directorio de empleados con datos, tres páginas y la aplicación ya publicada.

    $ bun run demo
  4. 4

    Comprobar la instalación

    La prueba de humo recorre el flujo completo: crear una aplicación, crear tablas, modificar columnas sin perder registros, publicar, invitar a un usuario y verificar que la clave del proveedor de IA no se expone al navegador.

    $ bun run smoke
Arquitectura

El servidor y PocketBase

El servidor de Planer sirve el panel, las aplicaciones publicadas y la API en el mismo puerto, el 3000 por defecto. PocketBase se ejecuta como proceso hijo.

Servidor Bun

Sirve el panel y las aplicaciones publicadas. También es el único proceso que modifica la estructura de las tablas.

PocketBase

Guarda los datos, las cuentas, los permisos y los archivos. Se inicia como proceso hijo del servidor.

PocketBase almacena las tablas con sus tipos de dato, índices y reglas de acceso.

Producción

Desplegar en un servidor de producción

$ bun run build
$ bun run start

El panel, las aplicaciones publicadas y la API quedan en un solo puerto.

Docker

Desplegar con una imagen de Docker

La imagen incluye el servidor y PocketBase. Los datos se guardan fuera de la imagen, en un volumen, y no es necesario instalar Bun ni descargar los componentes por separado.

$ docker build -t planer:1.0.0 .
$ docker compose up -d

En el servidor, copia .env.docker.example a .env.docker y cambia la contraseña de administrador antes de levantar los contenedores.

En una instalación nueva, revisa en la consola de PocketBase que la batch API esté habilitada y que batch.maxRequests quede en 200. La importación por lotes utiliza ese valor.

Empieza aquí

Instala Planer y crea la primera aplicación.

Con el servidor en marcha, describe lo que necesitas y revisa las tablas y las páginas que propone la IA.