Skip to content

docs: fix deno create page to require jsr:/npm: prefix#3108

Merged
bartlomieju merged 1 commit into
mainfrom
orch/issue-49
May 13, 2026
Merged

docs: fix deno create page to require jsr:/npm: prefix#3108
bartlomieju merged 1 commit into
mainfrom
orch/issue-49

Conversation

@lunadogbot
Copy link
Copy Markdown
Contributor

Summary

The deno create page claimed unprefixed package names default to JSR, but on Deno 2.7.14 the CLI errors out with Missing 'jsr:' or 'npm:' prefix. for any unprefixed argument (e.g. deno create @fresh/init, the page's own example, fails). A prefix (jsr: / npm:) or flag (--jsr / --npm) is required.

This brings the docs in line with current CLI behavior:

  • Rewrote the intro paragraph to say a prefix or flag is required, and quote the actual error.
  • Updated the JSR examples (deno create @fresh/initdeno create jsr:@fresh/init, including the -- --force variant and the inline @my-scope/my-template reference in the "How it works" section).
  • Dropped the (default) annotation from the --jsr flag — there is no default.

If the CLI later changes to actually default to JSR, the docs can be reverted to match — that's a runtime change tracked elsewhere.

Closes #3061
Closes bartlomieju/orchid-inbox#49

cc @bartlomieju

Test plan

  • deno create @fresh/init against denoland/deno:latest (2.7.14) errors with Missing 'jsr:' or 'npm:' prefix. — matches the updated docs.
  • deno create jsr:@fresh/init and deno create --jsr @fresh/init proceed past the prefix check.
  • Render the page locally and confirm the examples are copy-pasteable.

The page claimed unprefixed package names default to JSR, but the CLI
errors out with `Missing 'jsr:' or 'npm:' prefix.` when invoked without
a prefix or `--jsr` / `--npm` flag. Update the description, examples,
and `--jsr` flag annotation to match actual behavior.

Closes #3061
@bartlomieju bartlomieju merged commit d753043 into main May 13, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Feedback: /runtime/reference/cli/create/ - Needs Improvement

2 participants