Contributing to angular-movement

Thanks for helping improve angular-movement. This project aims to provide Angular-native motion primitives that feel predictable in production apps, not just impressive in demos.

Project shape

• projects/movement is the npm library.
• src is the AnalogJS documentation and demo site.
• The demo app imports the library source through the local movement path alias, so library changes show up immediately in demos.

Local setup

pnpm install
pnpm dev

Useful checks:

pnpm test:coverage
pnpm lint
pnpm run pack:check
pnpm build
pnpm e2e

For focused library tests:

pnpm exec ng test movement --include='**/move-hover.directive.spec.ts' --watch=false

What makes a good contribution

• Keep changes small and focused.
• Prefer Angular signals APIs such as input(), signal(), and effect().
• Keep DOM and browser APIs SSR-safe.
• Add or update tests for library behavior changes.
• Update the docs or demos when public API behavior changes.
• Avoid adding dependencies unless they clearly improve the library surface.

Commit style

This repo uses Conventional Commits:

feat: add moveStaggerStep alias
fix: cancel interrupted presence leave animations
docs: clarify drag constraints
test: cover nested variants

Allowed types are configured in .commitlintrc.json.

Pull request checklist

Before opening a PR, try to run:

pnpm test:coverage
pnpm lint
pnpm run pack:check

For UI or docs changes, also run:

pnpm build
pnpm e2e

If you cannot run a check locally, mention it in the PR description.

Release notes

Public API changes should update CHANGELOG.md. Keep unreleased changes under ## Unreleased until a version is prepared.