@clerk/clerk-js no longer has a headless export
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1.8k
- Forks
- 472
- Avg merge
- 2d 11h
- Merged PRs (30d)
- 189
Description
Preliminary Checks
-
I have reviewed the documentation: https://clerk.com/docs
-
I have searched for existing issues: https://github.com/clerk/javascript/issues
-
I have not already reached out to Clerk support via email or Discord (if you have, no need to open an issue here)
-
This issue is not a question, general help request, or anything other than a bug report directly related to Clerk. Please ask questions in our Discord community: https://clerk.com/discord.
Reproduction
n/a
Publishable key
n/a
Description
I just wanted to update our Clerk JS installation from version 5.125.9 to 6.28.1 and it seems like the headless export has disappeared? I also noticed that the new Clerk SDK has a lot of, to us, useless imports and weight we do not need:
- Billing + Checkouts + Stripe
- UI (un)mounting
- Waitlist handling
I am missing a true "core" or "headless" export like the one before. We do not use react, we only use Clerk for keeping the API keys and JWTs alive - that's it. Shipping the current @clerk/clerk-js version would be too much useless code for the client.
Environment
System:
OS: Linux 6.18 Ubuntu 22.04.1 LTS 22.04.1 LTS (Jammy Jellyfish)
CPU: (12) x64 AMD Ryzen 9 7950X 16-Core Processor
Memory: 14.82 GB / 23.47 GB
Container: Yes
Shell: 3.6.1 - /usr/bin/fish
Binaries:
Node: 24.15.0 - /mnt/wslg/runtime-dir/fnm_multishells/504944_1786549411768/bin/node
npm: 11.12.1 - /mnt/wslg/runtime-dir/fnm_multishells/504944_1786549411768/bin/npm
pnpm: 11.10.0 - /mnt/wslg/runtime-dir/fnm_multishells/504944_1786549411768/bin/pnpm
npmPackages:
@clerk/clerk-js: catalog: => 6.28.1
@clerk/shared: catalog: => 4.28.1
typescript: catalog: => 7.0.2
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by comparing the public exports of @clerk/clerk-js 5.125.9 and 6.28.1, then trace how the headless or core entry point changed. Confirm whether a supported headless export can avoid billing, Stripe, UI mounting, and waitlist code; done means a documented import works for the listed use case with less client weight.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- authentication
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100