{"id":15023951,"url":"https://github.com/sap/fundamental","last_synced_at":"2025-05-15T00:10:01.897Z","repository":{"id":37706187,"uuid":"108157725","full_name":"SAP/fundamental","owner":"SAP","description":"Fundamental Library - SAP Design System Component Library","archived":false,"fork":false,"pushed_at":"2025-03-24T13:57:48.000Z","size":137032,"stargazers_count":269,"open_issues_count":9,"forks_count":55,"subscribers_count":27,"default_branch":"main","last_synced_at":"2025-04-01T13:00:40.521Z","etag":null,"topics":["css","html5","open-source"],"latest_commit_sha":null,"homepage":"https://fundamental.netlify.app/","language":"SCSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SAP.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-24T17:01:41.000Z","updated_at":"2025-03-06T19:27:28.000Z","dependencies_parsed_at":"2024-01-14T06:53:12.438Z","dependency_job_id":"4980fc20-7bc4-48ce-97f5-8aee88842634","html_url":"https://github.com/SAP/fundamental","commit_stats":{"total_commits":1432,"total_committers":42,"mean_commits":"34.095238095238095","dds":0.6508379888268156,"last_synced_commit":"b413ccfe0290023fb75e0378061c1f310fc2093d"},"previous_names":[],"tags_count":232,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Ffundamental","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Ffundamental/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Ffundamental/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SAP%2Ffundamental/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SAP","download_url":"https://codeload.github.com/SAP/fundamental/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247856541,"owners_count":21007620,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","html5","open-source"],"created_at":"2024-09-24T19:59:38.563Z","updated_at":"2025-04-08T14:00:32.276Z","avatar_url":"https://github.com/SAP.png","language":"SCSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SAP Fundamentals\n\n**SAP Fundamentals is deprecated. [Fundamental Styles](https://sap.github.io/fundamental-styles) is its successor. If you are using this library consider migrating over to fundamental-styles.\nSAP Fundamentals' Documentation Site is hosted [here](https://sap.github.io/fundamental/old.html) for time being.**\n\n[![npm version](https://badge.fury.io/js/fiori-fundamentals.svg)](https://badge.fury.io/js/fiori-fundamentals)\n[![Build Status](https://travis-ci.org/SAP/fundamental.svg?branch=main)](https://travis-ci.org/SAP/fundamental)\n[![Slack](https://img.shields.io/badge/slack-ui--fundamentals-blue.svg?logo=slack)](https://ui-fundamentals.slack.com)\n[![REUSE status](https://api.reuse.software/badge/github.com/SAP/fundamental)](https://api.reuse.software/info/github.com/SAP/fundamental)\n\n\u003ca href=\"https://www.netlify.com\"\u003e\n  \u003cimg src=\"https://www.netlify.com/img/global/badges/netlify-light.svg\" alt=\"Deploys by Netlify\" /\u003e\n\u003c/a\u003e\n\n\n## What is SAP Fundamentals?\n\nSAP Fundamentals is a light-weight presentation layer that can be used with your UI framework of choice (e.g. Angular, React, Vue, etc.). With Fundamentals’ library of stylesheets and HTML tags, developers can build consistent Fiori apps in any web-based technology.\n\n**Learn more at http://sap.github.io/fundamental/old.html**\n\nWe are also working on [Angular](https://github.com/SAP/fundamental-ngx), [React](https://github.com/SAP/fundamental-react) and [Vue](https://github.com/SAP/fundamental-vue) implementations.\n\n\n## Getting Started\nThe library is modular so you can use as little or as much as you need.\n\n### CDN\nThe fully compiled, minified library is available via CDN for inclusion in your application.\n\n```\n\u003clink href=\"//unpkg.com/fiori-fundamentals@latest/dist/fiori-fundamentals.min.css\" rel=\"stylesheet\"\u003e\n```\n\n### NPM Package\n\nThe compiled CSS for the full library and modules, e.g., core, layout, etc., are distributed via [NPM](https://www.npmjs.com/package/fiori-fundamentals) along with the SASS source.\n\nThis gives you incredible flexibility to use individual components and enable [advanced customization](https://github.com/SAP/fundamental/wiki/Advanced-Customization) options.\n\n````\nnpm install fiori-fundamentals --save\n````\n\n\u003e NOTE: We only distribute the fonts, icons and compiled CSS and [the SASS source](https://github.com/SAP/fundamental/tree/main/scss), not the full project or HTML for specific components. If your project uses LESS, see [LESS compatible Fiori Fundamentals](https://github.com/SAP/fundamental/wiki/LESS-compatible-Fiori-Fundamentals).\n\n\n## Working with the Project\n\n### Download and Installation\n\n1. **Clone Repository** - Clone the repo using the git software of your choice or using the git command `git clone https://github.com/SAP/fundamental.git`\n\n1. **Install NPM Dependencies**: `npm install`\n\n1. **Install Ruby Gems** - These gems are needed to be installed for the documentation site. Navigate to the `docs` folder and `gem install ruby bundler jekyll`\n\n1. **Serve the documentation website locally** - `npm start`\n\n1. **Serve the development playground locally**: `npm run start:playground`\n\n### Project Dependencies\nThe project has the following prerequisites:\n\n* Git (for downloading this repo)\n* [Node LTS](https://nodejs.org/)\n* Ruby (for running the documentation website locally)\n\n\n## Known Issues\n\n### Configuring icons path when importing SCSS\n\nIf you are importing .scss files in your project, the icons path needs to be configured in your project's .scss file before the Fiori Fundamentals scss import as described below. Please note that the path variable name has to be `$fd-icons-path` in order to override the default value set in `scss/icons/icon.scss`.\n\n```\n$fd-icons-path : \"../node_modules/fiori-fundamentals/scss/icons/\"; // should be declared before the scss import\n\n@import \"../node_modules/fiori-fundamentals/scss/all.scss\";\n\n```\n\n## Support\n\nIf you encounter an issue, you can create a [ticket](https://github.com/SAP/fundamental/issues/new/choose) or post on the [Fundamentals Slack channel](https://join.slack.com/t/ui-fundamentals/shared_invite/enQtNTIzOTU0Mzc2NTc5LThlOTYxOGE3NGIzZDY3MGYyNjRiYWFlM2U0OGFjMGQ5YTA1MWU0ZjRjOTZmMGIzYWU1MmMyNzNjMjJhNzZhYzY).\n\n\n## Contributing\n\nIf you want to contribute, please check the [SAP Contribution Guidelines](https://github.com/SAP/.github/blob/main/CONTRIBUTING.md), the [Contribution Guidelines](https://github.com/SAP/fundamental/wiki/Contribution-Guidelines). Also check the [Development Guidelines](https://github.com/SAP/fundamental/wiki/Development-Guidelines) and [Visual Testing Guide](https://github.com/SAP/fundamental/wiki/Visual-Testing).\n\n\n## Versioning\n\nThe `fiori-fundamentals` library follows [Semantic Versioning](https://semver.org/). These components strictly adhere to the `[MAJOR].[MINOR].[PATCH]` numbering system (also known as `[BREAKING].[FEATURE].[FIX]`).\n\nMerges to the `main` branch will be published as a prerelease. Prereleases will include an **rc** version (_e.g._ `[MAJOR].[MINOR].[PATCH]-rc.[RC]`).\n\nThe following circumstances will be considered a MAJOR or BREAKING change:\n* Droppping existing classnames, css variables, color names, color groups, spacing parameters\n* The existing underlying HTML markup of a component is altered\n* An existing unit test is altered to account for either of the above\n\nThe following circumstances will NOT be considered a MAJOR or BREAKING change:\n* Introducing new  classnames, css variables, color names, color groups, spacing parameters\n* Non-visual HTML attribute changes/additions (such as `role`, `aria-*`, `data-*`)\n* Adding or modifying CSS properties and values of existing classnames.\n* An existing unit test is altered to account for non-visual HTML attribute changes/additions (such as `role`, `aria-*`, `data-*`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsap%2Ffundamental","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsap%2Ffundamental","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsap%2Ffundamental/lists"}