Skip to content
CAI
Software that uses CAICheck a score

AngelMunoz/Perla

48.4

Weak · 15 November 2026

13.5k

lines of production code

F#

with JavaScript

3

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Added Fira Code font support and PWA manifest for the sample app

The sample assets now include a CSS file defining the Fira Code typeface (including variable font support) and a web manifest file that configures the application as a standalone Progressive Web App with portrait orientation and a white background.

sample/assets · high confidence

Introduce Perla.Logger package with structured console output and status spinners

The new Perla.Logger library provides a unified logging interface for the Perla toolchain, leveraging Serilog for backend logging and Spectre.Console for rich, colored terminal output. Users benefit from structured log prefixes (e.g., Build, Serve, Browser) that categorize messages, along with visual status spinners for long-running asynchronous tasks. The logger supports customizable prefixes, optional exception display (with debug-specific details), and controls for line endings and ANSI escaping, ensuring consistent and readable console interactions across the platform.

src/Perla.Logger · high confidence

Introduce Perla.PkgManager for JSPM-based package management

Added the Perla.PkgManager module, which provides the core logic for installing, updating, and uninstalling JavaScript packages via the JSPM API. This new component handles downloading package files to a global cache, creating symlinks within the project's .perla directory, and extracting package metadata from various CDN providers (JSPM, esm.sh, jsDelivr, unpkg). It introduces types for import maps, generator options, and download responses, enabling the application to manage frontend dependencies with support for scoped packages and flat directory structures.

Perla.PkgManager · high confidence

Introduce plugin system with file transformation capabilities

The Perla.Plugins library now provides a structured way to define and execute plugins that transform source files. It introduces a \FileTransform\ record that tracks file content, extension, and source path, along with predicates to determine which files a plugin should process. Users can define plugins using a builder syntax that supports synchronous, Task-based, and Async transformations. The \PluginManager\ in the Registry module handles the lifecycle of these plugins, including loading them from code or text, managing FSI evaluation sessions, and executing them in a specified order against input files.

src/Perla.Plugins · high confidence

New Fable bindings for Mocha and QUnit testing frameworks

Added new F\# libraries (Perla.Fable.Mocha and Perla.Fable.QUnit) that provide type-safe bindings for the Mocha and QUnit JavaScript testing frameworks. The Mocha library exposes BDD-style interfaces (describe, it, context) and TDD-style interfaces (suite, test) with support for synchronous and asynchronous tests, hooks (before, after, beforeEach, afterEach), and test modifiers (only, skip). The QUnit library provides bindings for test definitions (test, testOnly, testSkip, testTodo, testIf), module management (module, moduleOnly, moduleSkip, moduleTodo, moduleIf), assertion helpers (Assert type with methods like equal, deepEqual, ok, throws), and an Expect module for fluent assertions.

Perla.Fable.Mocha, Perla.Fable.QUnit · high confidence

New Perla Dev Server sample app with Fable and Lit integration

A new sample application has been added to demonstrate a minimal Perla setup using Fable for F\# to JavaScript compilation and Lit for web components. The sample includes a configuration file (perla.json) that defines build paths, mounts directories, and specifies dependencies such as Lit and fsharp-components. It also provides an import map (perla.json.importmap) to resolve these dependencies via CDN or local packages, and an HTML entry point that loads the compiled Fable output as an ES module. This sample serves as a reference for users wanting to integrate F\# with modern web component frameworks using Perla's dev server.

sample · high confidence

New sample application with multilingual support and Lit integration

The sample application has been rewritten to demonstrate a Fable/Sutil frontend that integrates with Lit web components. It now features a language selector allowing users to switch between English, German, and Spanish, with translations loaded from a JSON file. The UI includes a notification generator form and displays notifications using custom Lit elements. Additionally, the sample embeds Lit-rendered content into specific DOM nodes and registers a custom web component, showcasing interoperability between the F\# stack and JavaScript-based Lit libraries.

sample/src · high confidence

Project initialization and repository structure setup

The repository has been initialized with the core project structure, including the new \Perla.slnx\ solution file (replacing the legacy \FSharp.DevServer.sln\), \.editorconfig\ for F\# formatting, and \global.json\ targeting .NET SDK 10.0.100. Essential documentation and community files have been added, such as \README.md\, \CONTRIBUTING.md\, \LICENSE\ (MIT), and \CODE\_OF\_CONDUCT.md\. The setup also includes Gitpod support (\.gitpod.yml\, \.gitpod.Dockerfile\), installation scripts for Linux/macOS (\install.sh\) and Windows (\install.ps1\), and JSON schemas for configuration (\perla.schema.json\) and templates (\perla.templates.schema.json\).

(repo-wide) · high confidence

Removals

Removal of FSharp.DevServer project scaffolding

The entire FSharp.DevServer project has been removed from the codebase. This deletion eliminates the previous development server implementation, including its command-line argument parsing (for server port, host, and public directory), build configuration, and server lifecycle management (start, stop, restart) built on Saturn and Giraffe. Users will no longer have access to this specific local development server tooling.

src/FSharp.DevServer · high confidence

Behavioural changes

162 commits (34 fixes) modifying Perla

A change to existing behaviour in Perla — 162 commits (34 fixs), 10 files: “half fix server to at least make it run”; “remove unnecessary optionals from core types levearage options for that”; “allow injects back for runtime TODO: check if this doesn't break builds”; and 158 more (refs \#135, \#99, \#12, \#140, \#143, …).

Perla · medium confidence · unverified

268 commits (48 fixes) modifying src/Perla

A change to existing behaviour in src/Perla — 268 commits (48 fixs), 41 files: “allow injects back for runtime TODO: check if this doesn't break builds”; “fix css compile in esbuild plugin”; “preliminary support for \#14”; and 260 more (refs \#14, \#138, \#135, \#99, \#12, …).

src/Perla · medium confidence · unverified

5 commits (1 fix) modifying App

A change to existing behaviour in App — 5 commits (1 fix), 1 file: “run fantomas 6”; “style: format code with fantomas 7”; “- Make project testable - Add Sample Tests”; and 2 more.

App · medium confidence · unverified

8 commits (1 fix) modifying Perla.Plugins

A change to existing behaviour in Perla.Plugins — 8 commits (1 fix), 1 file: “run fantomas 6”; “- Add Plugins Package”; “- fix missing plugins - allow to check against plugin predicates”; and 5 more (refs \#132).

Perla.Plugins · medium confidence · unverified

Updated offline templates to schema version 2025-07 and refreshed framework dependencies

The offline templates (basic, blocal, empty-fable, empty-jsx, fable-feliz) now use the 2025-07 schema version in their perla.json files. The Fable Feliz template has been updated to use React 19.1.0 and react-dom 19.1.0, and the Empty JSX template now uses Preact with esbuild JSX automatic mode. All templates include updated QUnit-based test suites and standardized project structures.

src/Perla/offline-templates · high confidence

Test coverage

1 commit adding/updating tests in App.Tests; Added comprehensive test suites for core Perla modules; Added unit tests for package manager core logic; Added unit tests for the Perla.Plugins library; Initial test suite for translation logic.

Dependencies

Migrate to .NET 8/10 and adopt central package management

The project has been upgraded from .NET 5 to support .NET 8 and .NET 10, with the main Perla CLI targeting both frameworks. A new \Directory.Packages.props\ file introduces central package management, defining specific versions for dependencies such as FSharp.Core (9.0.300), Fable.Core (4.5.0), and Microsoft.Playwright (1.52.0). This change replaces the legacy \FSharp.DevServer\ project and its older dependencies (e.g., Saturn, Argu) with a modernized structure including new packages like \Perla.Logger\ and \Perla.PkgManager\.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Baseline

  • First survey — no prior run to compare against. CAI 48.

Lenses

  • Code Health 41
  • Architecture 96
  • Maturity 51
  • Readiness 42
  • Security 81
  • Accessibility 66
  • Performance 100

Changes since last survey

  • 300 commits — 237 feature/other, 63 fixes

By area

  • src/Perla — 137 commits
  • (root) — 50 commits
  • tests/Perla.Tests — 21 commits
  • (repo) — 16 commits
  • .github/workflows — 13 commits
  • docs/assets — 13 commits
  • docs/src — 13 commits
  • .vscode/launch.json — 5 commits
  • src/Perla.PkgManager — 5 commits
  • src/Perla.Plugins — 5 commits
  • sample/src — 4 commits
  • .config/dotnet-tools.json — 3 commits
  • .devcontainer/Dockerfile — 2 commits
  • docs/index.html — 2 commits
  • src/Directory.Build.props — 2 commits
  • tests/Perla.Plugins.Tests — 2 commits
  • .devcontainer/devcontainer.json — 1 commit
  • .paket/Paket.Restore.targets — 1 commit
  • docs/.firebaserc — 1 commit
  • src/Flan — 1 commit

Notable commits

  • fix: Fix cache initialization in Extensibility.fs
  • fix: Fix esbuild 0.17+ download url changes
  • fix: Fix esbuild tests
  • fix: Fix plugin loading errors in Handlers.fs
  • fix: Fix setup failures as well as new
  • fix: Fixed helpActionAsync (requires Input.context) (#136)
  • fix: Merge pull request #121 from kaeedo/bugfix/FixTemplateNameParsing
  • fix: add env fixes
  • fix: change init name fix some tests update setup process
  • fix: ci: another fix
  • fix: ci: fix docs
  • fix: ci: fix docs
  • fix: ci: try fix ci
  • fix: ci: try fix ci
  • fix: fix #126
  • fix: fix broken docs from perla changes
  • fix: fix esbuild-ci
  • fix: fix live reload for js files... like wtf? that's what this tool is about!
  • fix: fix sample to run in dotnet8
  • fix: fix startup command
  • …and 280 more

Architecture

  • 0 containers · 7 bounded contexts · 2 dependency edges (baseline)

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

AngelMunoz/Perla was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 731531bc68407b3c5fa1c9dfb236eeb0ebba73c1 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.