JoshuaKGoldberg / JoshuaKGoldberg/create-typescript-app

📝 Documentation: Explain how to publish a new version

Open
#2,370 1 comment 0 reactions 0 assignees View on GitHub
area: documentation status: accepting prs
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

Open the contributing 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.