AlwaysConnected UI Library

A modern, reusable Angular component library for building consistent and beautiful user interfaces.

✨ Features

• ac-accordion: Expandable/collapsible content panels (coming soon)
• ac-combobox: Customizable combo box input
• ac-dropdown: Dropdown menu component
• ac-input: Styled input field
• ac-select: Custom select dropdown
• ac-spinner: Loading spinner
• ac-textarea: Styled textarea
• tag: Tag/badge component

👤 Author & Maintainer

Designed, developed, and maintained by:

• Farid Shojaemehr
  Software Engineer
  [email protected]

🚀 Installation

Install the package via npm:

npm i @alwayseducation/ui-kit

🛠️ Setup

Import the module in your Angular app or feature module:

import { AcInput } from '@alwayseducation/ui-kit';

@NgModule({
  imports: [
    AcInput,
    // ...other modules
  ],
})
export class AppModule { }

📦 Usage Examples

ac-combobox

<ac-combobox [options]="comboOptions" [(ngModel)]="selectedValue" />

ac-dropdown

<ac-dropdown [items]="dropdownItems" (select)="onSelect($event)" />

ac-input

<ac-input placeholder="Enter text" [(ngModel)]="inputValue" />

ac-select

<ac-select [options]="selectOptions" [(ngModel)]="selectedOption" />

ac-spinner

<ac-spinner />

ac-textarea

<ac-textarea placeholder="Enter description" [(ngModel)]="description" />

tag

<tag [label]="'New'" color="primary" />

📋 Notes

• All components support Angular forms via ngModel.
• For advanced usage and API details, see the source code or inline documentation.

🧑‍💻 Development

Clone the repo and install dependencies:

npm install

To start the local development server:

ng serve

To build the library:

ng build

To run unit tests:

ng test

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to open an issue or submit a pull request.

📚 Additional Resources

• Angular CLI Documentation
• Angular Official Docs

© 2025 AlwaysConnected UI. All rights reserved.