JoshuaKGoldberg / JoshuaKGoldberg/create-typescript-app
📝 Documentation: Explain how to publish a new version
- Dominant language
- TypeScript
- Stars
- 1.4k
- Forks
- 89
- Avg merge
- 1m
- Merged PRs (30d)
- 3
Description
### Documentation Report Checklist
- [x] I have looked at the latest `main` branch of the repository.
- [x] I have [searched for related issues](https://github.com/JoshuaKGoldberg/create-typescript-app/issues?q=is%3Aissue) and found none that matched my issue.
### Overview
As of the new npm trusted publishing requirements (#2270 & co.), I don't know the best / canonically correct way to make a new package with a new repository. Trusted publishing needs to be enabled, but how do you do that for a new package automatically?
Accepting docs PRs for someone to figure this out!
### Additional Info
The approximate steps I took for https://github.com/JoshuaKGoldberg/remark-add-twoslash were:
1. Run `npx create-typescript-app --remote` to create the package & upstream repo
2. Ran `pnpm build` locally
3. Ran `pnpm publish` locally to make a 0.0.*
4. Went to https://www.npmjs.com/package/remark-add-twoslash/access and set the Trusted Publisher settings to JoshuaKGoldberg / remark-add-twoslash / publish.yaml
If there's a way for create-typescript-app to do this automatically, that'd be lovely. Please file issue(s) (or just comment here if you're in a hurry) letting us know!
🎁
Contributor guide
Research direction
Start with the generated repository from `npx create-typescript-app --remote` and inspect its `publish.yaml` workflow alongside the reported `pnpm publish` steps. Verify the canonical npm trusted-publishing setup for a new package, then document the repeatable process and whether any setup can be automated.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- github-actions, nodejs, typescript
- Domain
- documentation, release
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100