How axafrance/design-system works
Project type and purpose
• This is a monorepo for AXA France’s Design System. It hosts multiple design-system packages (Slash, Apollo, Look-and-Feel) in both CSS and React flavors. It also provides Storybook “apps” to preview components, sample Vite project, documentation, linting configs, and CI/CD workflows.
File structure
• Top-level:
• .github/ – CI/CD workflows, issue templates, custom GitHub Actions
• apps/ – Storybook applications for each design system
• client/ – “published” design-system packages for Apollo & Look-and-Feel (CSS & React)
• slash/ – CSS & React implementations for Slash design system
• packages/ – sharable config packages (eslint, prettier, stylelint, postcss)
• samples/ – Vite sample consuming the design system
• docs/ – ADRs, guidelines, images
• scripts/ – build/publish helpers
• root configs: turbo.json, package.json, README.md, migration guides, CI configs
• Each design system has:
• css/ – SCSS sources, tokens, common styles, postcss config, turbo config
• react/ – component implementations, tests, utilities, tsconfigs, Vite/Storybook configs
• “apps” directory hosts Storybook containers that import the published packages to render component previews.
README for additional insights
• Purpose: single entry point for AXA France design system.
• Three flavors: Apollo (B2C public), Look & Feel (B2C client), Slash (B2B internal).
• Commands to start all or individual parts (dev & build), Storybook for React, CSS build.