Denhaag
Work in Progress: Den Haag Design System based on the NL Design System architecture
Overview:
The @gemeente-denhaag/components-react library is a collection of React components specifically designed for the municipality of The Hague. The goal of this library is to provide reusable components that can be easily customized to fit the branding and identity of other government organizations. The components have been used in various projects within The Hague, including the corporate website, satellite websites, open-source eForms, and the portal.
Features:
- Reusability: The components in this library are designed to be easily reused by other government organizations with minimal effort.
- Customization: Through the use of Design Tokens, it is possible to customize the components to match the corporate identity of the organization.
- Categorized Structure: The components are organized into categories, each with its own parent folder, making it easy to find and use the desired components.
- Storybook Integration: The library utilizes Storybook for testing components, allowing for easier development and testing.
- Lerna Package Management: Each component and category is its own package, managed with Lerna, to ensure modularity and maintainability.
- Cooperation with NL Design System: Some components in this library may become part of the NL Design System component library, allowing for broader adoption and collaboration.
Summary:
The @gemeente-denhaag/components-react library is a collection of reusable React components specifically designed for the municipality of The Hague. These components can be easily customized to fit the branding and identity of other government organizations. The library follows a categorized structure, utilizes Storybook for testing, and employs Lerna package management for modularity. With its cooperation with the NL Design System, this library aims to facilitate collaboration and wider adoption of its components. To get started, simply clone the repository and follow the installation steps provided.
- Express
Express.js is a simple Node.js framework for single, multi-page, and hybrid web applications.
- React
React is a widely used JavaScript library for building user interfaces and single-page applications. It follows a component-based architecture and uses a virtual DOM to efficiently update and render UI components
- SCSS
SCSS is a preprocessor scripting language that extends the capabilities of CSS by adding features such as variables, nesting, and mixins. It allows developers to write more efficient and maintainable CSS code, and helps to streamline the development process by reducing repetition and increasing reusability.
- UI Kits & Components
A UI kit provides developers with a set of reusable components that can be easily integrated into a website or application. These components are pre-designed with consistent styling and functionality, allowing developers to save time and effort in the design and development process. UI kits can be either custom-built or third-party, and often include components for buttons, forms, typography, icons, and more.
- Eslint
ESLint is a linter for JavaScript that analyzes code to detect and report on potential problems and errors, as well as enforce consistent code style and best practices, helping developers to write cleaner, more maintainable code.
- Postcss
PostCSS is a popular open-source tool that enables web developers to transform CSS styles with JavaScript plugins. It allows for efficient processing of CSS styles, from applying vendor prefixes to improving browser compatibility, ultimately resulting in cleaner, faster, and more maintainable code.
- Rollup
RollupJS is a popular and efficient JavaScript module bundler that takes the code from multiple modules and packages them into a single optimized file, minimizing the overall size of the application and improving its performance.
- Storybook
Storybook is a tool for developing and testing UI components in isolation. It provides a sandbox environment where you can experiment with different props and states to see how your component responds.
- Stylelint
Stylelint is a modern linter for CSS that helps you avoid errors and enforce consistent styling conventions. It provides rules for detecting errors and warnings, and can be configured to match your specific project's requirements.
- Typescript
TypeScript is a superset of JavaScript, providing optional static typing, classes, interfaces, and other features that help developers write more maintainable and scalable code. TypeScript's static typing system can catch errors at compile-time, making it easier to build and maintain large applications.