Skip to content
Projects

LuccaSA/lucca-front has 52 GitHub stars and 8 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 17:14 UTC. Last push 2026-11-13.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Update delayed
in 15 days
Update delayed
in 1 month
Update delayed

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

documentation

Web & Apps

README.md

Original

status - active slack-public - lucca-front miguell - 77 projets

Lucca Front

Lucca Front is a modular framework for developing web applications by lucca. It uses sub-packages architecture with unified versioning, à la angular.

Lucca Front contains 5 packages

Angular package depends on the SCSS one which depends itself on Icons.

Why Ng and Prisme packages ?

Historically, @lucca-front/ng contained both Design System components (Prisme) and Lucca specific business components. This created maintenance challenges as the Design System team needed to maintain atomic/molecular components while business units maintained domain-specific components (like department-select).

To solve this separation of concerns:

  • @lucca-front/prisme contains pure Design System components (atomic, molecular), maintained by the Design System team. This package is Open Source, promoting transparency and sharing.
  • @lucca-front/ng contains Lucca business components and domain-specific logic (API interactions, business data display), maintained by the respective business units. This package contains proprietary business logic.

This split ensures clear ownership, better maintenance, and respects the Open Source philosophy for the Design System while keeping business logic internal.

Full Split LF/Prisme documentation Distribution of LF/Prisme components

How to install

Add Lucca Front to your npm package

npm install @lucca-front/icons --save
npm install @lucca-front/scss --save
npm install @lucca-front/ng --save
npm install @lucca-front/prisme --save

Import packages styles

In your file styles.scss, add imports files and components you want to import to your project.

Basic setup

// Import core styles (required)
@forward '@lucca-front/icons/src/main';
@forward '@lucca-front/scss/src/main';
@forward '@lucca-front/ng/src/main';

Available SCSS components

For the complete list of available SCSS components organized by category, see the SCSS package documentation.

Import all components (not recommended)

To import all components at once:

// Import styles
@forward '@lucca-front/icons/src/main';
@forward '@lucca-front/scss/src/main-all';
@forward '@lucca-front/ng/src/main';

For custom imports, check our advanced usage documentation.

Include paths

In angular.json, we suggest to add a couple of entries to your paths:

"architect": {
  "build": {
    "options": {
      "stylePreprocessorOptions": {
        "includePaths": [
          "src/scss",
          "node_modules"
        ]
      },
    },
  },
},

Linting your styles

@lucca/stylelint-config-prisme is a shareable Stylelint configuration. It lints your code with the standard CSS & SCSS rules, adapts some of them for Lucca Front specifics, and warns about deprecated LF features (errors for deleted ones).

Install it as a dev dependency:

npm i --save-dev stylelint @lucca/stylelint-config-prisme

Then extend it in a stylelint.config.js file at your project root:

module.exports = {
  extends: ['@lucca/stylelint-config-prisme'],
  rules: {},
};

For CI, editor integration (VS Code, WebStorm), overrides, and troubleshooting, see the stylelint-config package documentation.

How to update

In order to activate schematics when they are available, we recommend to update Lucca Front using this command line:

lucca angular update

To check available options:

lucca angular update --help

To update a specific version of Lucca Front (@ points either to a specific version or a npm release channel):

npx ng update @lucca-front/[email protected]

For release:

npx ng update @lucca-front/ng@rc

If you want the latest version you can run this equivalent functions:

npx ng update @lucca-front/ng

or

npx ng update @lucca-front/ng@latest

AI agent skills

Every version of @lucca-front/ng ships documentation written for AI agents (node_modules/@lucca-front/ng/llms.txt and llms/): component APIs and examples, deprecations, changelog, CSS tokens, design and writing guidelines — all matching the installed version.

To make your agent (Claude Code, Copilot…) read it, install the lucca-front skill with APM. Add it to your project's apm.yml, without a ref:

dependencies:
  apm:
    - LuccaSA/lucca-front/.github/skills/lucca-front

Then run:

apm install

The skill is deployed under .claude/skills/lucca-front/ (and .github/skills/ for Copilot). It is a pointer to the documentation of the installed package, so there is nothing to change when you update Lucca Front.

dependencies:
  apm:
    - LuccaSA/lucca-front/.github/skills/lucca-front#vX.Y.Z

Already using lucca-front-<M>-<m> or lucca-front-all? Those folders no longer exist on master. If your installed package ships llms.txt, switch to the line above. Otherwise, pin your current path on #v22.1.0 until you update. See Migrating from the per-minor paths.

Other skills (migrations, deprecated APIs…) are listed in .github/skills/README.md.

Storybook

In order to work on Lucca Front, we use Storybook to display components.

  • Install volta.sh
  • Install node volta install node@lts
  • Run storybook npm start

Translations

Translations are hosted by Lokalise and imported with npm run i18n:update. Components accept partial overrides through their [intl] input.

See docs/translations.md.

Compatibility Table

Angular @lucca-front/ng @lucca/prisme Note
21.0 21.x 21.x Current version
20.0 20.4+ 20.4+ Support for Angular 20 & 21 since v20.4.0
19.0 19.x - Angular 19 only
18.0 18.x - Angular 18 only
17.0 17.x - Angular 17 only
16.0 16.x - Angular 16 only

Important notes:

  • Lucca Front follows the same major version as Angular (v21.x for Angular 21, v20.x for Angular 20, etc.)

Lucca Front et SemVer

Dépendances

@lucca-front/ng

graph TB
    ng["@lucca-front/ng"]
    
    %% Angular dependencies
    angular_common["@angular/common"] --> ng
    angular_core["@angular/core"] --> ng
    angular_cdk["@angular/cdk"] --> ng
    angular_animations["@angular/animations"] --> ng
    

License

The source code of this project is distributed under the Apache 2.0 license (see the LICENSE file). 

Please note: Assets (including but not limited to images, audio files, fonts, icons, trademarks, logos, brand names and other media files) included in this repository are NOT covered by this license. They remain the property of their respective owners and their use is subject to specific restrictions. Please respect these conditions.