phpmyadmin · pirulug · Aug 15, 2026
diff --git a/pirulug/.gitignore b/pirulug/.gitignore
@@ -0,0 +1,3 @@
+node_modules
+package-lock.json
+pnpm-lock.yaml
diff --git a/pirulug/LICENSE b/pirulug/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 - 2026 pirulug
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/pirulug/README.es.md b/pirulug/README.es.md
@@ -0,0 +1,75 @@
+# Pirulug PMA Theme
+
+Un tema moderno y compacto en modos Dark y Light para phpMyAdmin, desarrollado con Bootstrap 5.3 y Sass.
+
+[English version (Ingles)](README.md)
+
+![Vista previa](screen.png)
+
+## Caracteristicas
+
+- **Modos Dark y Light:** Soporte nativo para alternancia de modos mediante variables CSS y el atributo `data-bs-theme`.
+- **Tipografia Optimizada:** Tamano de fuente reducido (`0.875rem` / 14px base) para una densidad y legibilidad ideal en tablas de bases de datos.
+- **Paleta de Color Pirulug:** Acento primario `#ff0055` con contrastes calibrados para interfaces claras y oscuras.
+- **Iconografia Dinamica:** Soporte de iconos SVG adaptables automaticamente segun el modo de color activo.
+- **Compatibilidad:** Compatible con phpMyAdmin 5.0, 5.1, 5.2 y 6.0.
+
+## Instalacion
+
+1. Clona o copia esta carpeta dentro del directorio de temas de tu instalacion de phpMyAdmin:
+   - En phpMyAdmin estandar: `phpMyAdmin/themes/pma-pirulug-theme`
+   - En Laragon u otras distribuciones con directorio publico: `etc/apps/phpMyAdmin/themes/pma-pirulug-theme` y `etc/apps/phpMyAdmin/public/themes/pma-pirulug-theme`
+2. Abre phpMyAdmin en tu navegador.
+3. Ve a **Configuracion** > **Tema** y selecciona **Pirulug**.
+
+## Desarrollo y Compilacion
+
+El tema utiliza Sass para compilar los estilos hacia CSS:
+
+### Requisitos
+- Node.js (v16+)
+- npm
+
+### Comandos disponibles
+
+```bash
+# Instalar dependencias
+npm install
+
+# Compilar SCSS a CSS (desarrollo)
+npm run build
+
+# Compilar SCSS a CSS comprimido (produccion)
+npm run build:compile
+
+# Modo observador (recompila automaticamente al guardar cambios)
+npm run watch
+```
+
+## Estructura del Proyecto
+
+```text
+pma-pirulug-theme/
+├── css/                  # CSS compilado
+├── img/                  # Iconos e imagenes del tema
+│   └── dark/             # Iconos especificos para modo oscuro
+├── scss/                 # Codigo fuente SCSS
+│   ├── 0-functions/      # Funciones auxiliares
+│   ├── 1-variables/      # Variables de color, fuentes y temas
+│   ├── 2-mixins/         # Mixins reutilizables
+│   ├── 3-components/     # Botones, tarjetas y dropdowns
+│   ├── 4-layout/         # Estilos de navegacion, tablas, consola y layout
+│   ├── 6-vendor/         # Estilos de librerias externas
+│   ├── 7-hacks/          # Sobrescrituras y ajustes especificos
+│   └── theme.scss        # Archivo maestro SCSS
+├── package.json          # Scripts de compilacion y dependencias
+├── theme.json            # Metadatos del tema para phpMyAdmin
+├── README.md             # Documentacion en ingles
+└── README.es.md          # Documentacion en espanol
+```
+
+## Licencia
+
+Este proyecto esta bajo la Licencia MIT. Consulta el archivo [LICENSE](LICENSE) para mas detalles.
+
+**Autor:** Pirulug
diff --git a/pirulug/README.md b/pirulug/README.md
@@ -0,0 +1,75 @@
+# Pirulug PMA Theme
+
+A modern, compact Dark and Light theme for phpMyAdmin built with Bootstrap 5.3 and Sass.
+
+[Spanish version (Espanol)](README.es.md)
+
+![Preview](screen.png)
+
+## Features
+
+- **Dark & Light Modes:** Native mode switching using CSS variables and the `data-bs-theme` attribute.
+- **Optimized Typography:** Reduced base font size (`0.875rem` / 14px base) for dense, readable database tables and controls.
+- **Pirulug Color Palette:** Distinctive `#ff0055` primary accent color with calibrated contrast across light and dark backgrounds.
+- **Dynamic Iconography:** Automatic SVG icon adjustments based on the active color theme.
+- **Compatibility:** Supports phpMyAdmin 5.0, 5.1, 5.2, and 6.0.
+
+## Installation
+
+1. Clone or copy this repository into your phpMyAdmin themes directory:
+   - Standard phpMyAdmin: `phpMyAdmin/themes/pma-pirulug-theme`
+   - Laragon or installations with a public directory: `etc/apps/phpMyAdmin/themes/pma-pirulug-theme` and `etc/apps/phpMyAdmin/public/themes/pma-pirulug-theme`
+2. Open phpMyAdmin in your web browser.
+3. Navigate to **Settings** > **Theme** and select **Pirulug**.
+
+## Development and Build
+
+This theme uses Sass to compile styles into CSS:
+
+### Requirements
+- Node.js (v16+)
+- npm
+
+### Available Commands
+
+```bash
+# Install dependencies
+npm install
+
+# Compile SCSS to CSS (development)
+npm run build
+
+# Compile SCSS to compressed CSS (production)
+npm run build:compile
+
+# Watch mode (automatically recompile on file changes)
+npm run watch
+```
+
+## Project Structure
+
+```text
+pma-pirulug-theme/
+├── css/                  # Compiled CSS output
+├── img/                  # Theme icons and images
+│   └── dark/             # Dark-mode specific icons
+├── scss/                 # SCSS source code
+│   ├── 0-functions/      # Helper functions
+│   ├── 1-variables/      # Color, font, and theme variables
+│   ├── 2-mixins/         # Reusable mixins
+│   ├── 3-components/     # Buttons, cards, and dropdowns
+│   ├── 4-layout/         # Navigation, tables, console, and layouts
+│   ├── 6-vendor/         # External vendor styles
+│   ├── 7-hacks/          # Targeted overrides and adjustments
+│   └── theme.scss        # Master SCSS file
+├── package.json          # Build scripts and dependencies
+├── theme.json            # phpMyAdmin theme metadata
+├── README.md             # English documentation
+└── README.es.md          # Spanish documentation
+```
+
+## License
+
+This project is open source and available under the [MIT License](LICENSE).
+
+**Author:** Pirulug