Saltar al contenido

DOCUMENTACIÓN / PRIMEROS PASOS

Empieza aquí. Construye desde ahí.

Un recorrido breve del repositorio a una interfaz en ejecución. Puedes explorar el website y la aplicación antes de configurar el backend de autenticación.

Antes de empezar

Usa las versiones fijadas por el repositorio. Necesitas acceso al repositorio para clonar el código.

  • Node 24.15.0
  • pnpm 12.15.0
  • Git

01 Obtén el workspace

Clona el repositorio, entra al workspace e instala las dependencias del lockfile.

terminal / workspace
git clone https://github.com/visomi-dev/visomi-stack.git
cd visomi-stack
pnpm install --frozen-lockfile

02 Elige tu punto de entrada

Ejecuta un target en tu terminal. Déjalo en ejecución mientras exploras su URL local.

Website público

Servidor de desarrollo Astro. Empieza aquí para explorar el website y el catálogo UI.

Website público
pnpm nx serve web-site

Abrir: http://127.0.0.1:4200/es/

Aplicación de producto

Servidor de desarrollo Angular SSR, ejecutado de forma independiente.

Aplicación de producto
pnpm nx serve web-app --configuration=development-es

Abrir: http://localhost:4201/app/es/

Gateway compuesto

Construye y monta el website Astro compilado y la API Express.

Gateway compuesto
pnpm nx serve web-gateway

Abrir: http://localhost:3000/es/

¿Listo para configurar identidad?

La autenticación necesita PostgreSQL, secretos y proveedores configurados explícitamente. Sin esa configuración, las rutas de auth rechazan el acceso. Aun así puedes explorar el website público.

Guía de API e identidad

03 Ubica cada pieza

Las aplicaciones conservan sus puntos de entrada; las bibliotecas compartidas reúnen las piezas que usan entre ellas.

visomi-stack / workspace
apps/web/site/        Website Astro
apps/web/app/         Aplicación Angular
apps/web/api/         API Express
apps/web/gateway/     Composición HTTP
libs/web/frontend/ui/ Clases visuales compartidas

Verifica tus cambios

Ejecuta los targets Nx de la parte del stack que modificaste. Las pruebas de navegador del website usan el sitio compilado a través de Express.

terminal / Nx
pnpm nx run-many -t build lint typecheck -p web-site
pnpm nx e2e web-site

Sigue explorando