Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/digipolisantwerp/antwerp-ui_angular
Antwerp UI is a component interface library for building user interfaces and responsive web apps.
https://github.com/digipolisantwerp/antwerp-ui_angular
angular antwerp components
Last synced: 23 days ago
JSON representation
Antwerp UI is a component interface library for building user interfaces and responsive web apps.
- Host: GitHub
- URL: https://github.com/digipolisantwerp/antwerp-ui_angular
- Owner: digipolisantwerp
- License: mit
- Created: 2018-06-04T14:28:16.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-09-19T08:09:56.000Z (3 months ago)
- Last Synced: 2024-11-08T09:51:38.428Z (about 1 month ago)
- Topics: angular, antwerp, components
- Language: TypeScript
- Homepage: https://digipolisantwerp.github.io/antwerp-ui_angular
- Size: 35.1 MB
- Stars: 13
- Watchers: 9
- Forks: 19
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-angular - antwerp-ui_angular - Antwerp UI is a component interface library for building user interfaces and responsive web apps. (Table of contents / Third Party Components)
- fucking-awesome-angular - antwerp-ui_angular - Antwerp UI is a component interface library for building user interfaces and responsive web apps. (Table of contents / Third Party Components)
README
# Antwerp UI - Angular Components
![build][antwerp-ui-github-ci]
[![ngx-components-status]][ngx-components-package]
## Introduction
Antwerp City Platform as a Service User Interface (Antwerp UI) is a **component interface library** for building user interfaces and responsive web apps. It's designed to provide developers with functionality and UI/UX patterns that matches the Antwerpen styleguide.
## Ecosystem
This library is part of [Antwerp UI][antwerp-ui].
| Name | Framework | Status |
| ---------- | ----------- | -------------------------------------------------- |
| Javascript | ES5+ | [![antwerp-ui-js-github]][antwerp-ui-js] |
| Angular | Angular 15+ | [![antwerp-ui-angular-github]][antwerp-ui-angular] |
| React | React 16+ | [![antwerp-ui-react-github]][antwerp-ui-react] |
## Getting Started
### Running the project locally
- Use node version `18.x.x` (v. `18.12.1` at time of writing)
```shell
npm i
npm run build:all
npm start
```
### Troubleshooting
- If `Error: error:0308010C:digital envelope routines::unsupported` -> `export NODE_OPTIONS=--openssl-legacy-provider`
### Install Antwerp UI
```shell
npm i @acpaas-ui/ngx-utils
npm i @acpaas-ui/ngx-forms
// Other necessary libs for your app...
```
Edit styles.scss to import the branding look & feel.
```scss
@import url('https://cdn.antwerpen.be/core_branding_scss/6.6.6/main.min.css');
```
You can also modify `index.html` to reference the [favicons for the city of Antwerp][branding-favicons].
Then start using the components in your pages. Look at the component documentation below to learn how to use each component.
You can also add a branding-compatible [flexbox grid layout system][flexboxgrid]:
```scss
@import url('https://cdn.antwerpen.be/core_flexboxgrid_scss/3.0.0/flexboxgrid.min.css');
```
Note that you are free to use your own grid, as long as it meets our branding guidelines.
> To learn more about using the branding look & feel, check the [core branding guide][branding-core-guide]. Note that the [core branding][branding-core] contains the Antwerp logo and fonts, which are subject to a usage restriction. For use outside of apps for the city of Antwerp you can use [Digipolis branding][branding-digipolis] instead.
## Documentation
Check out our [live examples][antwerp-ui-angular-styleguide] or visit the [Antwerp UI site][antwerp-ui].
This library contains the following components:
| Name | Description | URL |
| ------------------- | ---------------------------------- | --------------------------------------------------------- |
| ngx-avatar | User avatar icon | [Documentation](./packages/ngx-avatar/README.md) |
| ngx-calendar | Calendar to select dates | [Documentation](./packages/ngx-calendar/README.md) |
| ngx-code-snippet | Snippet of source code | [Documentation](./packages/ngx-code-snippet/README.md) |
| ngx-context | Set meta tags for SEO | [Documentation](./packages/ngx-context/README.md) |
| ngx-flyout | Reveal additional content | [Documentation](./packages/ngx-flyout/README.md) |
| ngx-forms | Assorted form fields | [Documentation](./packages/ngx-forms/README.md) |
| ngx-layout | Assorted page layout components | [Documentation](./packages/ngx-layout/README.md) |
| ngx-logo | Logo icon | [Documentation](./packages/ngx-logo/README.md) |
| ngx-leaflet | Leaflet-based map | [Documentation](./packages/ngx-leaflet/README.md) |
| ngx-pagination | Pagination control | [Documentation](./packages/ngx-pagination/README.md) |
| ngx-progress-bar | Progress bar control | [Documentation](./packages/ngx-progress-bar/README.md) |
| ngx-selectable-list | List control with selectable items | [Documentation](./packages/ngx-selectable-list/README.md) |
| ngx-table | Interactive table | [Documentation](./packages/ngx-table/README.md) |
| ngx-utils | Assorted helpers | [Documentation](./packages/ngx-utils/README.md) |
| ngx-user-menu | User Menu providing login/logout | [Documentation](./packages/ngx-user-menu/README.md) |
## Testing
### Test automation
If you want to start automating your tests, you can have a look at our [Test Automation Guide](./TEST_AUTOMATION.md) for some tips on how to use data-attributes to keep your tests stable and maintainable.
### Cross Browser Testing
We are using [Browserstack Live](https://www.browserstack.com/live) to make sure that our components work correctly on all major browsers and platforms.
The people at Browserstack kindly offer an unlimited testing program, free of charge for open source projects so a big thanks to them!
## Questions
For questions and support please ask a question on the [#antwerp-ui slack channel][antwerp-ui-slack]. If you're not yet a member of our DigAnt Café slack community, you can easily [join here](https://digantcafe-slack.digipolis.be).
If you stumble across a bug or missing feature, feel free to [report an issue][antwerp-ui-angular-issues]. Please fill out the issue template completely when [opening an issue][antwerp-ui-angular-issues]. This will help us get to your issue sooner.
## Changelog
Detailed changes for each release are documented in the [changelog](./CHANGELOG.md).
## Contributing
Your contributions are most welcome as pull requests, both code changes and documentation updates. However, to keep a high quality standard, please make sure to read the [Contributing Guide](./CONTRIBUTING.md) before making a pull request.
Thank you to all the people [who already contributed][antwerp-ui-angular-contributors] to Antwerp UI!
## Support
Jasper Van Proeyen ()
## License
[MIT](./LICENSE.md)
Copyright (c) 2016-present, Digipolis
[antwerp-ui]: https://antwerp-ui.digipolis.be
[antwerp-ui-slack]: https://digantcafe.slack.com/messages/CDDLYJU65/
[flexboxgrid]: https://github.com/a-ui/core_flexboxgrid_scss
[antwerp-ui-schematics]: https://github.com/digipolisantwerp/antwerp-ui_schematics
[antwerp-ui-js]: https://github.com/digipolisantwerp/antwerp-ui_js
[antwerp-ui-angular]: https://github.com/digipolisantwerp/antwerp-ui_angular
[antwerp-ui-angular-styleguide]: https://digipolisantwerp.github.io/antwerp-ui_angular
[antwerp-ui-angular-issues]: https://github.com/digipolisantwerp/antwerp-ui_angular/issues
[antwerp-ui-angular-contributors]: https://github.com/digipolisantwerp/antwerp-ui_angular/graphs/contributors
[antwerp-ui-react]: https://github.com/digipolisantwerp/antwerp-ui_react
[branding-core]: https://github.com/a-ui/core_branding_scss
[branding-core-guide]: https://a-ui.github.io/core_branding_scss/
[branding-digipolis]: https://github.com/a-ui/digipolis_branding_scss
[branding-favicons]: https://github.com/a-ui/core_branding_favicons
[antwerp-ui-angular-github]: https://img.shields.io/github/package-json/v/digipolisantwerp/antwerp-ui_angular.svg
[antwerp-ui-js-github]: https://img.shields.io/github/package-json/v/digipolisantwerp/antwerp-ui_js.svg
[antwerp-ui-react-github]: https://img.shields.io/github/package-json/v/digipolisantwerp/antwerp-ui_react.svg
[antwerp-ui-github-ci]: https://github.com/digipolisantwerp/antwerp-ui_angular/workflows/CI/badge.svg
[ngx-components-package]: https://www.npmjs.com/package/@acpaas-ui/ngx-components
[ngx-components-status]: https://img.shields.io/npm/v/@acpaas-ui/ngx-components.svg