PHPackages                             tenryuubito/alice - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. tenryuubito/alice

ActiveTypo3-cms-extension[Utility &amp; Helpers](/categories/utility)

tenryuubito/alice
=================

TYPO3 Site Package for performance &amp; analytics

10PHP

Since Apr 8Pushed 3mo agoCompare

[ Source](https://github.com/Tenryuubito/Alice)[ Packagist](https://packagist.org/packages/tenryuubito/alice)[ RSS](/packages/tenryuubito-alice/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Alice - TYPO3 Asset Bridge &amp; Performance Dashboard
======================================================

[](#alice---typo3-asset-bridge--performance-dashboard)

**Alice** is a comprehensive TYPO3 extension designed to streamline modern frontend development and provide deep insights into website performance and SEO health. It acts as a bridge for Vite-based asset processing while offering a centralized Command Center for performance audits and technical SEO monitoring.

Key Features
------------

[](#key-features)

### ⚡ Vite Build System

[](#-vite-build-system)

- **Infrastructure Decoupling**: Build assets from any extension using a centralized build engine.
- **HMR Support**: Instant Hot Module Replacement for Stylesheets and TypeScript during development.
- **Environment Aware**: Automatic switching between production bundles and development source files.

### 📊 Performance Analytics (Core Web Vitals)

[](#-performance-analytics-core-web-vitals)

- **Real-User Metrics**: Measures LCP (Largest Contentful Paint), CLS (Layout Shift), and INP (Interaction to Next Paint).
- **Iframe Sandbox**: Audits are performed in an isolated, technically visible environment to ensure accurate paint metrics.
- **Batch Auditing**: Analyze entire site trees with a single click from the Global Dashboard.

### 🔍 Technical SEO &amp; Accessibility

[](#-technical-seo--accessibility)

- **Meta Discovery**: Automated validation of Title tags, Meta Descriptions, and Robots directives.
- **Image Health**: Comprehensive audit of Alt-text availability, dimension attributes, and lazy-loading compliance.
- **Link Reachability**: Server-side verification of internal and external link status codes with detailed response time reporting.

---

Installation &amp; Setup
------------------------

[](#installation--setup)

### 1. Requirements

[](#1-requirements)

- TYPO3 v12.4+ or v14.2+
- Node.js v18.0+
- Composer-based TYPO3 installation

### 2. Node.js Environment

[](#2-nodejs-environment)

Alice manages its own Node dependencies. Initialize or build the environment via the TYPO3 CLI:

```
# Setup dependencies
./vendor/bin/typo3 alice:bundle --setup

# Start development server (HMR)
./vendor/bin/typo3 alice:bundle --dev

# Production build
./vendor/bin/typo3 alice:bundle --build
```

### 3. Registering Entry Points

[](#3-registering-entry-points)

Register your extension's assets in `ext_localconf.php` or `Configuration/Services.yaml`:

```
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['alice']['additional_entries'][] = 'EXT:my_ext/Resources/Private/TypeScript/Main.ts';
```

---

Dashboard Usage
---------------

[](#dashboard-usage)

### Commands &amp; Overview (UID 0)

[](#commands--overview-uid-0)

The Alice module at the root node (UID 0) serves as a **Global Command Center**.

- **Site Overview**: View the performance status of all recognized sites.
- **Batch Run**: Trigger performance audits for all pages across all domains.
- **Issue Aggregation**: A centralized list of all SEO and performance issues found across the entire TYPO3 instance.

### Page-Specific Audit (UID &gt; 0)

[](#page-specific-audit-uid--0)

Selecting a specific page in the page tree provides a detailed drill-down into its metrics.

- **Live Preview Audit**: Trigger an audit that renders the page in the background and reports real-time vitals.
- **Detailed Findings**: Accordions for Images, Links, and SEO provide actionable feedback.

---

Configuration
-------------

[](#configuration)

### Site Configuration

[](#site-configuration)

Configure audit behavior per site in the Site Management module:

- **Performance Thresholds**: Define targets for LCP, CLS, and INP.
- **Auto Lazy-Loading**: Toggle the automatic `loading="lazy"` middleware.

### Extension Settings

[](#extension-settings)

Manage global defaults via the Extension Configuration:

- **Asset Paths**: Customize the build output directories.
- **Audit Runner**: Configure the background measurement timeout.

---

Technical Architecture
----------------------

[](#technical-architecture)

### Audit Service

[](#audit-service)

The audit workflow is split into two phases:

1. **Frontend Capture**: An iframe renders the target page and executes the `AuditRunner.ts` (using Google's Web-Vitals library) to capture technical performance.
2. **Backend Analysis**: The `BackendController` parses the HTML server-side to identify SEO flaws, accessibility issues, and link brokenness.

### Asset Middleware

[](#asset-middleware)

Alice utilizes PSR-15 middlewares to intercept frontend requests:

- `ViteAssetMiddleware`: Maps production assets to the Vite Dev Server in development context.
- `LazyLoadingMiddleware`: Injects loading attributes into image tags to improve initial paint time.

---

(c) 2026 Tenryuubito

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance55

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/d0e061ed8feac39699a3cf0f9be0e65466a1758bf2522360ff3bc056e7fecacb?d=identicon)[\_tenryuubito](/maintainers/_tenryuubito)

### Embed Badge

![Health badge](/badges/tenryuubito-alice/health.svg)

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

###  Alternatives

[sheadawson/silverstripe-dynamiclists

A Module that allows users to create custom data lists. These lists can then be used in a form control (specified via code by a developer) or within a user defined form to be able to define controlled vocabularies managed in a central location that might be used across several forms.

107.2k](/packages/sheadawson-silverstripe-dynamiclists)

PHPackages © 2026

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