PHPackages                             liquidstack/core - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. liquidstack/core

ActiveComposer-plugin[Framework](/categories/framework)

liquidstack/core
================

Core de arranque, routing y helpers para el framework Liquid Stack (repositorio: liquidstack-core). Incluye módulos JS/SCSS con animaciones GSAP

v1.4.01(1mo ago)086[1 issues](https://github.com/LiquidArtDevelopers/LIQUIDSTACK-CORE/issues)MITJavaScriptPHP >=8.1

Since Nov 18Pushed 1mo agoCompare

[ Source](https://github.com/LiquidArtDevelopers/LIQUIDSTACK-CORE)[ Packagist](https://packagist.org/packages/liquidstack/core)[ Docs](https://github.com/LiquidArtDevelopers/liquidstack-core)[ RSS](/packages/liquidstack-core/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (8)Versions (54)Used By (0)

Liquid Stack Core
=================

[](#liquid-stack-core)

`liquidstack/core` es el paquete comun para proyectos Liquid Stack. Centraliza:

- Nucleo PHP (arranque, routing, helpers).
- Stubs backend reutilizables (`stubs/App`, `stubs/public`).
- Recursos frontend reutilizables (`resources/js`, `resources/scss`, `resources/img`).
- Dependencias frontend minimas del core (`package.core.json`).

Como sincroniza en proyectos cliente
------------------------------------

[](#como-sincroniza-en-proyectos-cliente)

Al ejecutar `composer install` o `composer update` en un proyecto que consume este paquete:

1. Se copian stubs backend desde `stubs/` al proyecto.
2. Se copian recursos frontend:

- `resources/js` -> `src/js/resources` (y copia en `vendor/liquidstack/core/resources/js`).
- `resources/scss` -> `src/scss/resources` (y copia en `vendor/liquidstack/core/resources/scss`).
- `resources/img` -> `public/assets/img`.

3. Se fusionan dependencias de `package.core.json` en el `package.json` del proyecto consumidor.

Scripts disponibles:

```
composer liquidstack-core:sync-resources
composer liquidstack-core:sync-frontend-deps
```

Alias legado soportado:

```
composer stack-liquid-core:sync-resources
```

Variables de entorno soportadas:

- `STACK_CORE_RESOURCES_TARGET` (alias: `STACK_LIQUID_CORE_RESOURCES_TARGET`).
- `STACK_CORE_RESOURCES_IMG_TARGET` (alias: `STACK_LIQUID_CORE_RESOURCES_IMG_TARGET`).

Checklist: traer un recurso nuevo desde liquidstack\_base
---------------------------------------------------------

[](#checklist-traer-un-recurso-nuevo-desde-liquidstack_base)

Usa esta lista cada vez que subas un recurso nuevo al core.

### 1) Frontend del recurso

[](#1-frontend-del-recurso)

- Anadir JS en `resources/js`.
- Anadir SCSS en `resources/scss`.
- Si el recurso requiere imagenes:
- Dummies generales en `resources/img/dummy`.
- Imagenes especificas del recurso en `resources/img/resources/`.

Nota de estructura de imagenes
------------------------------

[](#nota-de-estructura-de-imagenes)

Esa estructura se conserva en destino. Ejemplo:

- Origen: `resources/img/resources/aniBackground01/*`
- Destino: `public/assets/img/resources/aniBackground01/*`

### 2) Registro del recurso en plantillas base del core

[](#2-registro-del-recurso-en-plantillas-base-del-core)

- Actualizar `src/js/templates.js` (imports + init del recurso).
- Actualizar `src/scss/templates.scss` (imports SCSS del recurso).

Importante sobre `src/scss/_config.scss`, `src/scss/_global.scss` y `src/js/_global.js`
---------------------------------------------------------------------------------------

[](#importante-sobre-srcscss_configscss-srcscss_globalscss-y-srcjs_globaljs)

Esos archivos **no** se sincronizan automaticamente a proyectos cliente en el instalador actual. Solo se sincronizan de `src/`:

- `src/js/templates.js`
- `src/scss/templates.scss`

Por tanto:

- Los archivos `_config.scss` y `_global.scss` del proyecto cliente no se pisan.
- En este core se mantienen como referencia/base para desarrollo, pero no como override forzado en clientes.

### 3) Backend/stubs del recurso

[](#3-backendstubs-del-recurso)

- Actualizar idiomas de templates en:
- `stubs/App/config/languages/templates/es.json`
- `stubs/App/config/languages/templates/en.json`
- `stubs/App/config/languages/templates/eu.json`
- Anadir controlador en `stubs/App/controllers/.php`.
- Anadir template en `stubs/App/templates/_.html`.
- Actualizar `stubs/App/views/_templates.php` para mostrar el ejemplo del recurso.

### 4) Dependencias NPM del recurso

[](#4-dependencias-npm-del-recurso)

Si el recurso necesita librerias nuevas (ejemplo `three`):

- Declararlas en `package.core.json`.

Reglas de fusion en proyecto cliente:

- Solo agrega paquetes faltantes.
- No borra paquetes del proyecto.
- No reemplaza versiones ya declaradas por el proyecto.

Guia de trabajo local (localhost:1309)
--------------------------------------

[](#guia-de-trabajo-local-localhost1309)

Este repositorio no trae una app completa para renderizar por si solo. La forma recomendada es trabajar con un proyecto laboratorio basado en `liquidstack_base` usando este core local enlazado.

### Paso 1) Preparar proyecto laboratorio

[](#paso-1-preparar-proyecto-laboratorio)

En el `composer.json` del proyecto laboratorio, usar repositorio `path` hacia este core local:

```
{
  "repositories": [
    {
      "type": "path",
      "url": "../LIQUIDSTACK-CORE",
      "options": { "symlink": true }
    }
  ]
}
```

Luego:

```
composer update liquidstack/core
```

Con `symlink: true`, los cambios que hagas en este repo se reflejan en el proyecto laboratorio.

### Paso 2) Instalar frontend del laboratorio

[](#paso-2-instalar-frontend-del-laboratorio)

```
npm install
```

### Paso 3) Levantar Vite en puerto 1309

[](#paso-3-levantar-vite-en-puerto-1309)

```
npm run dev -- --host localhost --port 1309
```

Si el script `dev` del laboratorio ya fija host/port, basta con `npm run dev`.

### Paso 4) Refrescar sincronizaciones cuando toque

[](#paso-4-refrescar-sincronizaciones-cuando-toque)

Si cambias recursos en `resources/`:

```
composer liquidstack-core:sync-resources
```

Si cambias dependencias en `package.core.json`:

```
composer liquidstack-core:sync-frontend-deps
```

Si cambias stubs o `src/js/templates.js` / `src/scss/templates.scss`, ejecuta:

```
composer update liquidstack/core
```

Publicacion de cambios del core
-------------------------------

[](#publicacion-de-cambios-del-core)

1. Subir cambios al repo de `liquidstack/core`.
2. Etiquetar version SemVer.
3. En cada proyecto cliente: `composer update liquidstack/core`.
4. Ejecutar instalacion frontend del proyecto (`npm install`, `pnpm install` o `yarn install`) si se anadieron dependencias.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance89

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

44

Last Release

54d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/91fcdba8b32bf551171276c110bee8cd6016e055f950fb6cc2088afafa2a2df0?d=identicon)[Liquid Art Developers](/maintainers/Liquid%20Art%20Developers)

---

Top Contributors

[![LiquidArtDevelopers](https://avatars.githubusercontent.com/u/20877962?v=4)](https://github.com/LiquidArtDevelopers "LiquidArtDevelopers (67 commits)")

### Embed Badge

![Health badge](/badges/liquidstack-core/health.svg)

```
[![Health](https://phpackages.com/badges/liquidstack-core/health.svg)](https://phpackages.com/packages/liquidstack-core)
```

###  Alternatives

[getkirby/cms

The Kirby core

1.5k535.5k352](/packages/getkirby-cms)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[doppar/framework

The Doppar Framework

366.7k8](/packages/doppar-framework)[chameleon-system/chameleon-base

The Chameleon System core.

1026.5k3](/packages/chameleon-system-chameleon-base)[impresscms/impresscms

ImpressCMS is an open source content management system with a focus on security and speed

291.1k](/packages/impresscms-impresscms)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)