Skip to content

Flubio/angularUse

Repository files navigation

AngularUse

Collection of Angular-first utilities and state helpers, inspired by the developer experience of VueUse.

Why this project

Angular has powerful primitives (Signals, DI, RxJS), but many apps repeatedly implement similar utility patterns. AngularUse aims to provide reusable, tree-shakeable helpers with strong TypeScript support and a clean API.

Inspiration and credit

This project is inspired by VueUse and its excellent model for ergonomic utility composition.

Huge credit to the VueUse maintainers and contributors for setting a high bar for API design, docs quality, and open-source stewardship.

Current status

  • Early-stage library
  • Core state utilities in progress
  • APIs may evolve before stable release

Package(s)

  • ngx-use — Angular utility library

Getting started

Prerequisites

  • Node.js 20+
  • pnpm 10+

Install dependencies

pnpm install

Build

pnpm build

Test

pnpm test

Project structure

projects/
	ngx-use/
		src/
			lib/
				core/
					state/
					di/

Roadmap

  • Scaffold library workspace
  • Add createGlobalState
  • Add createProvidedState (with createInjectionState compatibility alias)
  • Add createSharedState
  • Add useAsyncState
  • Add strongly typed DI token helper (createTypedToken)
  • Add additional state and browser utilities
  • Improve API docs and examples
  • Stabilize v1 surface

Contributing

Contributions are welcome. Please start with CONTRIBUTING.md.

Quick flow:

  1. Fork the repository
  2. Create a feature branch
  3. Add tests for your changes
  4. Open a pull request

Acknowledgements

  • VueUse — primary inspiration
  • Angular team and ecosystem maintainers

License

This project is licensed under the MIT License.

Please also review our Code of Conduct.

About

Collection of essential Angular Composition Utilities inspired by VueUse

Resources

License

Code of conduct

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors