LuccaSA/lucca-front
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.
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 & AppsREADME.md
OriginalLucca 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
- a set of icons @lucca-front/icons
- a SCSS framework @lucca-front/scss
- a library of lucca components @lucca-front/ng
- a library of design system components @lucca-front/prisme
- a shareable stylelint configuration @lucca/stylelint-config-prisme
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/prismecontains pure Design System components (atomic, molecular), maintained by the Design System team. This package is Open Source, promoting transparency and sharing.@lucca-front/ngcontains 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>orlucca-front-all? Those folders no longer exist onmaster. If your installed package shipsllms.txt, switch to the line above. Otherwise, pin your current path on#v22.1.0until 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.)
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.