# ngx-clerk

> Unofficial Clerk SDK for Angular (Angular 20+, Clerk Core 3 / ClerkJS v6). Signals-based auth state, prebuilt Clerk components, route guards, and directives.

## Docs

- [Home](https://anagstef.github.io/ngx-clerk/): Overview of ngx-clerk — the unofficial Angular SDK for Clerk authentication, covering features, installation, and requirements.
- [Quickstart](https://anagstef.github.io/ngx-clerk/quickstart.html): Step-by-step guide to adding Clerk authentication to a new Angular 20+ app with ngx-clerk.
- [Authentication](https://anagstef.github.io/ngx-clerk/authentication.html): How to add sign-in/sign-up pages, auth buttons, control-flow directives, and an SSO callback route.
- [Protecting routes](https://anagstef.github.io/ngx-clerk/protecting-routes.html): How to restrict routes and template sections by authentication state, role, or permission.
- [Reading auth state](https://anagstef.github.io/ngx-clerk/reading-auth-state.html): How to read Clerk's reactive state — user, session, and organization — from Angular signals via ClerkService.
- [Session tokens](https://anagstef.github.io/ngx-clerk/session-tokens.html): How to retrieve session JWTs with getToken() and attach them to backend requests.
- [Organizations & roles](https://anagstef.github.io/ngx-clerk/organizations.html): How to render organization components and gate access by role, permission, feature, or plan.
- [Components](https://anagstef.github.io/ngx-clerk/components.html): All 13 Clerk UI components for Angular with their inputs.
- [ClerkService](https://anagstef.github.io/ngx-clerk/clerk-service.html): Every signal and method on ClerkService, with effect() and error-handling examples.
- [Migration v0 to v1](https://anagstef.github.io/ngx-clerk/migration.html): Upgrade an app from ngx-clerk v0.x to v1.
- [Use with AI agents](https://anagstef.github.io/ngx-clerk/ai-agents.html): Point your coding agent at ngx-clerk's LLM-ready docs and skills.
- [Demo & contributing](https://anagstef.github.io/ngx-clerk/contributing.html): Run the demo, tests, lint, and e2e locally, and how builds, docs, and releases work.

## Optional

- [Migration guide (raw)](https://raw.githubusercontent.com/anagstef/ngx-clerk/main/MIGRATION.md): plain-markdown v0 to v1 upgrade guide
- [Agent skills](https://github.com/anagstef/ngx-clerk/tree/main/skills): installable skills for AI coding agents