@mnaoumov/create-obsidian-plugin 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -0,0 +1,137 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 1.4.0 (2026-11-01)
+
+### Features
+
+- The `official-sample` preset writes the `LICENSE` copyright line as `Copyright (C) <year> by <author>`, keeping upstream's 0BSD text.
+- A See also section compares similar scaffolders, in the README and on the docs site.
+- `CHANGELOG.md`, back-filled from the tags, linked from the README and the docs site.
+- Tool names are marked as code in all Markdown prose, with a test that catches a bare one.
+
+### Removed
+
+- The `enhanced` preset alias: `--preset=enhanced` now fails validation like any unknown value.
+- Every migration of an older `.create-obsidian-plugin.json` answer shape (`framework`, `cssMode`, `buildSystem`, `gitHubFunding`, a missing `defaultBranch` or `coverageBadge`, a stored `pluginShortName`).
+
+[Full diff](https://github.com/mnaoumov/create-obsidian-plugin/compare/1.3.0...1.4.0)
+## 1.3.0 (2026-11-01)
+
+### Features
+
+- **cli:** quote the -- separator in --help and the answers-file hint
+
+[Full diff](https://github.com/mnaoumov/create-obsidian-plugin/compare/1.2.0...1.3.0)
+
+## 1.2.0 (2026-11-01)
+
+### Features
+
+- **template:** add a Similar plugins section to the generated README
+- **template:** let a parenthesized folder group templates without entering their path
+- **issue-templates:** give the bug form field ids that bug-report links prefill
+- tell AI agents how to file an issue when they skip the forms
+- scaffold the Report a bug command whenever issue forms are chosen
+
+### Fixes
+
+- **deps:** float brace-expansion to 5.0.12 and fast-uri to 3.1.9 past their advisories
+- **versions:** drop the smol-toml advisory override now that typescript-dev-toolkit 3.7.3 pins 1.9.1
+- **templates:** select .obsidian-lib in the framework stylesheets
+- **templates:** show the plugin name as code in the demo sample view
+- **gate:** report a missing package manager as could not run, not a failed install
+- **bundler:** leave esbuild to obsidian-dev-toolkit on the framework presets
+- **lint:** discover root ESLint config for scripts
+- **lint:** reconcile unused binding checks with ESLint 10
+- **templates:** format Solid readonly configuration comment
+- override vulnerable development KaTeX dependency
+- **demo:** avoid keyword identifier in number setting callback
+- **demo:** stop scaffolding the gitignored scratch note
+- **versions:** override re2js to ^2.9.1 in scaffolded projects for GHSA-gg6h-894w-4m9c
+- **spell-checker:** know "toolkits" in the emitted cspell.json
+- **versions:** hold toolkit-declared packages in the toolkit's range
+
+[Full diff](https://github.com/mnaoumov/create-obsidian-plugin/compare/1.1.0...1.2.0)
+
+## 1.1.0 (2026-10-21)
+
+### Features
+
+- scaffold onto @mnaoumov/obsidian-lib and the @mnaoumov toolkits
+- **templates:** take commitlint and nano-staged configs from typescript-dev-toolkit
+- **preset:** keep preset "enhanced" working as a deprecated alias of all-in-one
+- **preset:** label the preset All-in-one Framework and lead its hint with the helper library
+- **preset:** add the Official sample plugin preset
+- **docs-showcase:** extract, wrap and type-check the developer docs' code blocks
+- **preset:** add the Developer docs showcase preset
+- **upstream-sync:** watch every upstream and open one update PR per change
+- **docs-showcase:** link each snippet's docs page from what its command shows
+- **templates:** link Discussions from the issue chooser
+- **formatter:** run prettier and biome through the toolkit runners
+- **test-runner:** run jest through the toolkits on the framework presets
+- **e2e:** run wdio-obsidian and obsidian-test through obsidian-dev-toolkit
+- **github-actions:** call obsidian-dev-toolkit's reusable workflows
+- **bundler:** build every bundler through obsidian-dev-toolkit's adapters
+- **scaffold:** emit .nvmrc so CI runs the project's Node, not the latest LTS
+- **docs-showcase:** recognize a code-examples-only LICENSE and refuse unknown ones
+
+### Fixes
+
+- **demo-vault:** import configureCommunityPlugin from @mnaoumov/obsidian-lib
+- **dprint:** keep JSX attributes double-quoted
+- **versions:** override smol-toml to clear GHSA-r4xh-jqrq-34v2
+- **verify-tarball:** read npm 12's keyed npm pack --json output as well as the array
+- **templates:** emit nano-staged config patterns in sorted order
+- **templates:** require CodeScript Toolkit 13.8.0 for the demo-vault injection
+- **templates:** drop the preact view's import-x/no-deprecated directives for preact 11
+- **templates:** remove the three directives the previous commit left staged out
+- **cli:** let render:case and gate:case read a deprecated answer value as the CLI does
+- **update:** ask every question again when the user chooses to change settings
+- **templates:** pass the framework scaffolds' own lint, format and audit gate
+- **verify:** read the pins step's checks from under the pins key
+- **versions:** pin @codemirror/state and view to obsidian 1.14.4's peers
+- **prompts:** offer "Keep current tooling" on update and make "Use recommended defaults" apply them
+- **cli-args:** look the mode up instead of asserting a string to the Mode enum
+- **templates:** clear what the toolkit runners and verify:projects found
+- **templates:** keep biome and dprint agreeing on the framework configs
+- **standalone:** clear the gate failures the wdio install used to hide
+- **templates:** reach the CSS module through its class names so vite keeps it
+- **test:** declare sweepCases' void return so tsc accepts the generator
+- **templates:** ignore coverage/ in git and cspell, spell-check staged dotfiles
+- **scaffold:** install the git hooks after git init and make the first commit conventional
+- **demo-vault:** stop linking to the gitignored scratch note
+- **cspell:** know the word the template's word list adds for the demo vault .gitignore
+- **plugin-drift:** leave generator-scaffolded plugins out of the real-plugin set
+- **versions:** read the smol-toml pin off typescript-dev-toolkit's markdownlint-cli2
+- **templates:** mark the plugin name as code in the README and demo-vault prose
+
+[Full diff](https://github.com/mnaoumov/create-obsidian-plugin/compare/1.0.2...1.1.0)
+
+## 1.0.2 (2026-10-10)
+
+### Features
+
+- verify obsidian-dev-utils source links against its checkout
+
+### Fixes
+
+- **verify-tarball:** pack with --ignore-scripts so HUSKY=0 output cannot break the JSON
+- **templates:** point dead upstream links at their current homes
+
+[Full diff](https://github.com/mnaoumov/create-obsidian-plugin/compare/1.0.1...1.0.2)
+
+## 1.0.1 (2026-10-07)
+
+### Other
+
+- publish to npm from GitHub Actions with trusted publishing
+
+[Full diff](https://github.com/mnaoumov/create-obsidian-plugin/compare/1.0.0...1.0.1)
+
+## 1.0.0 (2026-10-07)
+
+Initial release.
+
+[Commits](https://github.com/mnaoumov/create-obsidian-plugin/commits/1.0.0)

package/README.md

@@ -4,354 +4,50 @@
 
 A scaffolding CLI that generates [Obsidian](https://obsidian.md/) plugin projects from modern templates. Supports creating new plugins and updating existing ones.
 
-## Create a new plugin
-
-| Package manager | Runner | Command                                     |
-|-----------------|--------|---------------------------------------------|
-| npm             | create | `npm create @mnaoumov/obsidian-plugin`      |
-| npm             | npx    | `npx @mnaoumov/create-obsidian-plugin`      |
-| pnpm            | create | `pnpm create @mnaoumov/obsidian-plugin`     |
-| pnpm            | dlx    | `pnpm dlx @mnaoumov/create-obsidian-plugin` |
-| yarn            | create | `yarn create @mnaoumov/obsidian-plugin`     |
-| yarn            | dlx    | `yarn dlx @mnaoumov/create-obsidian-plugin` |
-| bun             | create | `bun create @mnaoumov/obsidian-plugin`      |
-| bun             | bunx   | `bunx @mnaoumov/create-obsidian-plugin`     |
-
-This walks you through an interactive wizard to scaffold a new Obsidian plugin project with optional post-scaffold actions (npm install, git init, GitHub repo creation).
-
-The wizard first asks for the project's own details — plugin id, name and description, your name and GitHub username, the default branch (`main` unless you say otherwise; `git init` creates it and the CI workflow triggers on it), where people can support you (a funding platform and your username on it, or any URL), and the path to a test vault's config folder — then the feature options below.
-
-The id, name and description are checked against what the Obsidian Community directory's automated review enforces, and a rejection says which rule you hit. That matters most for the id: the directory re-reads your `manifest.json` when you submit, and an id can never be changed once your plugin is published.
-
-## Update an existing plugin
+**Documentation: <https://mnaoumov.dev/create-obsidian-plugin/>** — every option and prompt, the generated project, updating, custom templates and more.
 
-Run the same command inside a project previously created with this tool:
+## Create a new plugin
 
 ```bash
 npm create @mnaoumov/obsidian-plugin
 ```
 
-The updater will:
-
-- Detect the existing project via `.create-obsidian-plugin.json`
-- Compare file hashes to detect local modifications
-- Update unmodified files to the latest template version
-- Skip files you've customized (with a warning)
-- Create any new files added to the template
-
-## Non-interactive use
+This walks you through an interactive wizard, then scaffolds the project into a new `obsidian-<plugin id>` folder. `pnpm`, `yarn` and `bun` work too: see [Getting started](https://mnaoumov.dev/create-obsidian-plugin/guides/getting-started/).
 
-Every question the wizard asks can be answered up front instead, which is what lets generation be scripted and repeated.
+Run the same command inside a project it created to [update it](https://mnaoumov.dev/create-obsidian-plugin/guides/updating/) to the latest templates, keeping the files you changed.
 
-| Option | What it does |
-|--------|--------------|
-| `-y`, `--yes` | Take the default for every unanswered question, and skip the post-scaffold prompts, so nothing is installed, formatted or committed. The closing `Next steps` line lists what is left, including `format` on prettier and biome, which the project's own `format:check` fails until it has run once. It never asks anything: a question no flag answers stops the run with an error naming the flag |
-| `--mode=create\|update` | Create a new plugin, or update the project in the current directory, without being asked which. Under `--yes` it is required when the current directory holds a `.create-obsidian-plugin.json` |
-| `--force` | Scaffold into an `obsidian-<pluginId>` directory that already exists, instead of being asked. Under `--yes` it is required when that directory exists |
-| `-h`, `--help` | List every option, including the accepted values for each answer |
-| `--answersFile=<path>` | Read answers from a JSON file |
-| `--customTemplate=<dir>` | Layer your own templates over the built-in ones — see [Your own templates](#your-own-templates) |
-| `--latest` | With `--preset=official-sample`: copy the official sample plugin as it is upstream today, rather than the snapshot this release ships — see [Official sample plugin](#official-sample-plugin) |
-| `--<answer>=<value>` | Set one answer, e.g. `--packageManager=yarn` |
+## Example
 
-Because `npm create` needs to be told which flags are yours rather than its own, npm takes a `--` first; pnpm, yarn and bun do not:
+Answer every question up front and skip the prompts:
 
 ```bash
-npm create @mnaoumov/obsidian-plugin -- --yes --pluginId=my-tool --packageManager=yarn
-pnpm create @mnaoumov/obsidian-plugin --yes --pluginId=my-tool --packageManager=pnpm
-```
-
-Answers are applied in order, so the most specific wins: built-in defaults, then the answers saved in an existing project, then `--answersFile`, then individual flags. An answer given this way is not asked about again. On an update, `--yes` reuses the project's saved answers with any flags applied over them, instead of asking whether to change them.
-
-The answers file is a JSON object using the same names. It also accepts a whole `.create-obsidian-plugin.json`, so you can point it at an existing project to scaffold another one like it:
-
-```json
-{
-  "preset": "all-in-one",
-  "bundler": "esbuild",
-  "packageManager": "npm",
-  "pluginId": "my-tool"
-}
-```
-
-Invalid input is refused rather than quietly ignored: an unknown answer, a value outside what a question accepts, a plugin id the wizard itself would reject, or `--currentYear` and `--pluginShortName`, which the generator computes rather than asks for.
-
-### Saving the answers from an interactive run
-
-At the end of the wizard, before scaffolding, you can save what you just answered as either form — a runnable script (`.cmd` on Windows, `.sh` elsewhere) or an answers file. You can save both and then generate; saving does not end the run. Every answer is written, not only the ones that differ from a default, so the recipe keeps producing the same project after a release changes a default.
-
-## Your own templates
-
-When the answers cannot express what every plugin of yours needs, keep it in a directory of your own and pass `--customTemplate=<dir>`. The directory mirrors the generator's `templates/default` and is searched ahead of it, so it uses the same EJS templates and the same partials:
-
-```text
-my-obsidian-template/
-  overlay.json
-  README.md@support_mine.ejs   # adds a section at an existing render('support') seam
-  LICENSE.ejs                  # replaces the built-in LICENSE
-  docs/NOTES.md.ejs            # a file the built-ins do not have
-```
-
-```json
-{
-  "partials": ["mine"],
-  "files": ["docs/NOTES.md"],
-  "packages": ["type-fest"],
-  "badges": ["[![Docs](https://img.shields.io/badge/docs-here-blue)](https://example.com)"]
-}
+npm create @mnaoumov/obsidian-plugin "--" --yes --pluginId=my-tool --packageManager=npm
 ```
 
-- A template at a built-in's path replaces it, but only when your answers emit that file: a `vite.config.ts.ejs` does nothing on an esbuild project.
-- A folder whose name is in parentheses, such as the built-ins' `scripts/(build)/`, only groups templates and is not part of their path. So `scripts/build.ts.ejs` and `scripts/(build)/build.ts.ejs` are the same template, and you may group your own files the same way or not at all.
-- `partials` names what your partial files contribute. The names share one namespace with the built-in partials, so a name the generator already uses is refused. Your partials render after the built-in ones at every seam.
-- `files` lists the paths you add, without `.ejs`. A built-in path is refused there; to replace one, just place its template.
-- `packages` are added to `devDependencies`, and their versions are resolved when you generate, as the built-in ones are.
-- `badges` go after the built-in badges, on the same README line.
-
-The directory is checked before any question is asked. A template that nothing would ever emit, a partial nobody declared, a section no template renders, or any other file (except `overlay.json` and a `README.md` of its own) stops the run with the reason.
-
-The directory is recorded in `.create-obsidian-plugin.json`, relative to the project, and an update applies it again. That keeps the files it produced updating cleanly rather than looking hand-edited. Pass `--customTemplate=<dir>` on an update to point at a moved directory, or `--customTemplate=` to stop using one. A recorded directory that is missing stops the update instead of quietly reverting your files to the built-ins.
-
-## Feature options
-
-The wizard lets you pick and choose from the following categories:
-
-### Preset
-
-| Option               | Description                                                                                                                                                                                                                                                                                                                                           |
-|----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| All-in-one Framework | Recommended. The author's framework: [@mnaoumov/obsidian-lib](https://github.com/mnaoumov/obsidian-lib), a library of ready-made helpers for settings, commands, modals, notices, file and link handling, and more, plus the @mnaoumov toolkits for building, linting, testing and releases. `"preset": "enhanced"` still works as a deprecated alias |
-| Demo                 | All features enabled for demonstration                                                                                                                                                                                                                                                                                                                |
-| Developer docs showcase | The All-in-one Framework project, plus every code block of the [Obsidian developer docs](https://docs.obsidian.md) as a command you can run. See [Developer docs showcase](#developer-docs-showcase) |
-| Standalone           | Standalone plugin without the @mnaoumov library dependencies                                                                                                                                                                                                                                                                                          |
-| Official sample plugin | Exactly [obsidianmd/obsidian-sample-plugin](https://github.com/obsidianmd/obsidian-sample-plugin), with your plugin's id, name, author and description filled in. See [Official sample plugin](#official-sample-plugin) |
-
-#### Official sample plugin
-
-`"preset": "official-sample"` gives you Obsidian's own sample plugin as it is, rather than a project built from this tool's templates. No other question is asked: upstream has already chosen its tooling (esbuild, ESLint with `eslint-plugin-obsidianmd`, npm), and a tooling flag beside this preset is refused.
-
-Only the plugin's identity changes:
-
-- `manifest.json`: `id`, `name`, `description`, `author`, `authorUrl` (your GitHub profile) and `fundingUrl`, which is removed if you choose no funding platform
-- `package.json` and `package-lock.json`: the package name, `obsidian-<id>`
-- `README.md`: the title
-
-Every other file is upstream's, byte for byte, including its 0BSD `LICENSE` and its `AGENTS.md`. The generator adds only its own `.create-obsidian-plugin.json`, which is what lets an update work the way it does for every preset.
-
-The files come from a snapshot this release ships, pinned to an upstream commit in `upstreams.json`, so generating works offline and gives the same result every time. Pass `--latest` to copy upstream as it is today instead; if upstream cannot be reached, the shipped snapshot is used with a warning.
-
-Upstream's `npm run lint` fails on a fresh copy, and on upstream itself, until you rename the sample classes and remove the sample code: `eslint-plugin-obsidianmd` checks for exactly that. `npm run build` passes.
-
-#### Developer docs showcase
-
-`"preset": "docs-showcase"` generates the All-in-one Framework project and adds `src/docs/`: every code block of [obsidianmd/obsidian-developer-docs](https://github.com/obsidianmd/obsidian-developer-docs), each one a command. Open the command palette, type `Docs:`, and run `Docs: Vault > Modify files` to see that block of the Vault page work against a scratch note.
-
-Each block is kept as the docs show it. The generator adds only what the docs leave to the reader: the imports a block leaves out, and a host that gives the block a plugin to register things on, a note to work with, an editor, or an element to draw into. A block that declares a plugin class is loaded as a child plugin, and running its command again unloads it. A stylesheet is applied and removed the same way.
-
-`src/docs/README.md` lists every block of the docs. A block that does not compile against the `obsidian` API, or that is not plugin code (shell commands, JSON samples, diagrams), is listed there with the reason rather than left out silently.
-
-The blocks are type-checked by `src/docs/tsconfig.json`, which carries the official sample plugin's compiler options, so the project's own stricter `tsconfig.json`, linter, formatter and spell checker leave the folder alone. With the vitest answer, `npm run test:integration:desktop` runs every `Docs:` command in a real Obsidian and fails on any that throws.
-
-The blocks come from a snapshot this release ships, pinned to an upstream commit in `upstreams.json`. Maintainers refresh it with `npm run sync:docs-showcase`.
-
-### Bundler
-
-| Option  | Description                              |
-|---------|------------------------------------------|
-| esbuild | Fast and simple (recommended)            |
-| Parcel  | Zero-config bundler                      |
-| Rollup  | Flexible with plugin ecosystem           |
-| Vite    | Modern dev server with HMR               |
-| Webpack | Mature bundler with broad plugin support |
-
-### UI framework
+Keep the quotes around `"--"`: in PowerShell a bare `--` is swallowed before `npm` sees it. See [The -- separator in PowerShell](https://mnaoumov.dev/create-obsidian-plugin/guides/powershell-separator/). Every option is listed in [Command-line options](https://mnaoumov.dev/create-obsidian-plugin/guides/command-line/).
 
-| Option | Description                               |
-|--------|-------------------------------------------|
-| (none) | Plain TypeScript, no UI framework         |
-| Lit    | Web Components with declarative templates |
-| Preact | Lightweight React alternative (3kB)       |
-| React  | Component-based UI with JSX               |
-| Solid  | Fine-grained reactivity, no virtual DOM   |
-| Svelte | Lightweight reactive components           |
-| Vue    | Progressive framework with SFC            |
+[Sample Plugin Extended](https://github.com/mnaoumov/obsidian-sample-plugin-extended) is a plugin generated with this tool.
 
-### Linter
+## See also
 
-| Option | Description                                 |
-|--------|---------------------------------------------|
-| (none) | No linting                                  |
-| Biome  | Fast linter and formatter                   |
-| ESLint | Industry standard for JavaScript/TypeScript |
-
-### Formatter
-
-| Option   | Description                              |
-|----------|------------------------------------------|
-| (none)   | No formatting                            |
-| Biome    | Fast formatter (pairs with Biome linter) |
-| dprint   | Fast, pluggable, written in Rust         |
-| Prettier | Opinionated, widely adopted              |
-
-### Spell checker
-
-| Option | Description                         |
-|--------|-------------------------------------|
-| (none) | No spell checking                   |
-| cspell | Configurable spell checker for code |
-
-### Markdown linter
-
-| Option       | Description                                   |
-|--------------|-----------------------------------------------|
-| (none)       | No Markdown linting                           |
-| markdownlint | Lint Markdown files for style and consistency |
-
-### Unit testing
-
-| Option | Description                  |
-|--------|------------------------------|
-| (none) | No unit testing              |
-| Jest   | Feature-rich, widely adopted |
-| Vitest | Fast, Vite-native, ESM-first |
-
-### E2E testing
-
-| Option        | Description                                               |
-|---------------|-----------------------------------------------------------|
-| (none)        | No E2E testing                                            |
-| obsidian-test | Tests run inside Obsidian with real app APIs              |
-| wdio-obsidian | WebdriverIO service for Obsidian, multi-version and CI/CD |
-
-### Editor extensions
-
-| Option     | Description                                          |
-|------------|------------------------------------------------------|
-| (none)     | No editor extensions                                 |
-| CodeMirror | CodeMirror 6 state fields, view plugins, decorations |
-
-### Styling
-
-| Option       | Description                              |
-|--------------|------------------------------------------|
-| (none)       | No custom styles                         |
-| CSS          | Plain CSS styles                         |
-| CSS Modules  | Scoped CSS with .module.css files        |
-| PostCSS      | CSS with plugins (autoprefixer, nesting) |
-| SCSS         | Sass/SCSS preprocessor                   |
-| Tailwind CSS | Utility-first CSS framework              |
-
-### WebAssembly support
-
-| Option | Description                  |
-|--------|------------------------------|
-| (none) | No WASM                      |
-| WASM   | Import and use .wasm modules |
-
-### Commit linting
-
-| Option               | Description                      |
-|----------------------|----------------------------------|
-| (none)               | No commit linting                |
-| Conventional Commits | commitlint + husky + lint-staged |
-
-### Hot reload
-
-| Option            | Description                                                                             |
-|-------------------|-----------------------------------------------------------------------------------------|
-| (none)            | No hot reload support                                                                   |
-| Hot Reload Plugin | Creates `.hotreload` marker for [Hot Reload](https://community.obsidian.md/plugins/hot-reload) |
-| Obsidian CLI      | Reloads via `obsidian plugin:reload` CLI command                                        |
-
-### Internationalization
-
-| Option        | Description                                   |
-|---------------|-----------------------------------------------|
-| (none)        | No internationalization                       |
-| i18next       | Popular i18n framework with JSON translations |
-| typesafe-i18n | Type-safe i18n with auto-generated types      |
-
-### GitHub Actions
-
-| Option       | Description                          |
-|--------------|--------------------------------------|
-| (none)       | No GitHub Actions workflows          |
-| CI + Release | CI + automated release on tag push   |
-| CI           | CI workflow only (lint, test, build) |
-
-### GitHub issue templates
-
-| Option        | Description                              |
-|---------------|------------------------------------------|
-| (none)        | No issue templates                       |
-| Bug & Feature | Bug report and feature request templates |
-
-### Coverage badge
-
-| Option         | Description                                                    |
-|----------------|----------------------------------------------------------------|
-| (none)         | No coverage badge                                              |
-| Coverage badge | A `coverage: 100%` badge at the end of the README's badge line |
-
-### Funding
-
-Asked with the project details, not under Customize. The platform and your username on it produce the `fundingUrl` in `manifest.json`, the README's badge and `## Support` link, and a `.github/FUNDING.yml` with that one platform's line. `(none)` emits none of them.
-
-| Option          | Description                                                |
-|-----------------|------------------------------------------------------------|
-| (none)          | No funding link, FUNDING.yml or badge                      |
-| Buy Me a Coffee | buymeacoffee.com/&lt;username&gt;                          |
-| GitHub Sponsors | github.com/sponsors/&lt;username&gt;                       |
-| Ko-fi           | ko-fi.com/&lt;username&gt;                                 |
-| Liberapay       | liberapay.com/&lt;username&gt;                             |
-| Open Collective | opencollective.com/&lt;username&gt;                        |
-| Patreon         | patreon.com/&lt;username&gt;                               |
-| Polar           | polar.sh/&lt;username&gt;                                  |
-| thanks.dev      | thanks.dev/&lt;username&gt;, e.g. `u/gh/<GitHub username>` |
-| Custom URL      | Any other URL, asked for as a URL rather than a username   |
-
-### Obsidian API subset
-
-| Option                | Description                                                |
-|-----------------------|------------------------------------------------------------|
-| Official API          | Stable, documented API only                                |
-| Official + Unofficial | Includes internal undocumented APIs (for experienced devs) |
-
-### Package manager
-
-| Option | Description                         |
-|--------|-------------------------------------|
-| Bun    | Fast all-in-one JavaScript toolkit  |
-| npm    | Default, comes with Node.js         |
-| pnpm   | Fast, efficient disk space          |
-| Yarn   | Classic alternative with workspaces |
-
-### Platform support
-
-| Option             | Description                        |
-|--------------------|------------------------------------|
-| Desktop and mobile | Plugin works on desktop and mobile |
-| Desktop only       | Plugin works only on desktop       |
-
-## Configuration file
-
-The `.create-obsidian-plugin.json` file stores:
-
-- `generatorVersion` — version of the generator that created the project
-- `fileHashes` — SHA-256 hashes of generated files for update detection
-- `answers` — every answer, which an update reuses
-- `customTemplate` — the [custom template](#your-own-templates) directory, if one was used
+[My other Obsidian resources](https://github.com/mnaoumov/obsidian-resources)
 
-## Architecture
+| Tool | Features | How `create-obsidian-plugin` differs |
+| --- | --- | --- |
+| [`@aoout/create-obsidian-plugin`](https://www.npmjs.com/package/@aoout/create-obsidian-plugin) | `npm create` wizard, forked from zephraph's `create-obsidian-plugin`; `i18next`; a tag-triggered release workflow; a desktop-only option; `git init` and an optional GitHub repository | Same goal; adds: presets; a choice of bundler, UI framework, linter, formatter and test runner; an update in place that keeps the files you edited; `--yes` and answers export |
+| [`cookiecutter-obsidian-plugin`](https://github.com/serafinovsky/cookiecutter-obsidian-plugin) | A Python `cookiecutter` template; TypeScript, `esbuild`, `eslint`, `prettier`; optional `vitest` and i18n; a release workflow | Same goal; runs on Node.js through `npm create`, with no Python; adds: presets; five bundlers; UI frameworks; an update in place |
+| [`create-obsidian-plugin`](https://www.npmjs.com/package/create-obsidian-plugin) | The `npm init obsidian-plugin` wizard by zephraph; asks for the id and name; a TypeScript plugin whose `dev` and `build` scripts run `obsidian-plugin-cli` | Same goal; adds: presets; a tooling choice in each category; an update in place; `--yes` and answers export |
+| [`create-obsidian-plugin-pnpm`](https://www.npmjs.com/package/create-obsidian-plugin-pnpm) | An `npm create` scaffolder that copies one fixed template; `pnpm`, strict TypeScript, `esbuild`, `eslint`; CI and draft-release workflows; a declarative settings example | Same goal; adds: `npm`, `yarn` and `bun`; presets; a choice of bundler, UI framework, linter, formatter and test runner; an update in place |
+| [`dsebastien/obsidian-plugin-template`](https://github.com/dsebastien/obsidian-plugin-template) | A GitHub template repository; `bun`, strict TypeScript, `tailwindcss` 4, `eslint`, `prettier`, `husky` with `lint-staged`, `commitizen`; CI and release workflows | A generator rather than a template you copy and rename by hand; fills in your plugin's identity from prompts or flags; a choice in each tooling category; an update in place |
+| [`generator-obsidian-plugin`](https://github.com/mnaoumov/generator-obsidian-plugin) (my tool) | A Yeoman generator (`yo obsidian-plugin`); `obsidian-typings`, `eslint`, `cspell`, `dprint`, `obsidian-dev-utils` scripts; `svelte` and `react` examples; `sass` | Supersedes it; needs no global `yo`; adds: presets; a choice in each tooling category; an update in place that keeps the files you edited; `--yes` |
+| [`nolebase/obsidian-plugin-template`](https://github.com/nolebase/obsidian-plugin-template) | A GitHub template repository; TypeScript, `unbuild`, `eslint`, `cspell`, `pnpm`; publishing on release | A generator rather than a template you copy and rename; five bundlers, `unbuild` not among them; UI frameworks; an update in place |
+| [`obsidianmd/obsidian-sample-plugin`](https://github.com/obsidianmd/obsidian-sample-plugin) | Obsidian's official template repository; TypeScript, `esbuild`, `eslint` with `eslint-plugin-obsidianmd`, `npm`; sample code | Extends it: the `official-sample` preset copies it with your id, name, author, description and license holder filled in, and can update it later; the other presets add a choice of tooling |
 
-- **EJS templates** with a partial-based composition system
-- **Logicless templates** — no `<% if %>` conditionals; conditional content via partials
-- **Two-tier scripts** — standalone has full inline scripts; All-in-one Framework wraps `@mnaoumov/obsidian-dev-toolkit` and `@mnaoumov/typescript-dev-toolkit`
-- **Root configs are thin wrappers** — actual logic lives in `scripts/`
+Last searched for similar tools on 2026-11-01.
 
-## Sample output
+## Changelog
 
-See [Sample Plugin Extended](https://github.com/mnaoumov/obsidian-sample-plugin-extended).
+All notable changes to this project will be documented in the [CHANGELOG](./CHANGELOG.md).
 
 ## Contributing
 
@@ -371,10 +67,6 @@ Open issues through the [issue forms](https://github.com/mnaoumov/create-obsidia
 
 Filing from the CLI or the API (`gh issue create --body`, or an AI agent filing for you) skips the form, and `gh issue create --template` cannot load an issue form. In that case, open the matching form in [`.github/ISSUE_TEMPLATE/`](https://github.com/mnaoumov/create-obsidian-plugin/tree/HEAD/.github/ISSUE_TEMPLATE), copy every field as a `### <label>` heading in the form's order, and fill in each one. Always state the version you used and your operating system.
 
-## My other Obsidian resources
-
-[My other Obsidian resources](https://github.com/mnaoumov/obsidian-resources)
-
 ## License
 
 © [Michael Naumov](https://github.com/mnaoumov/)

package/dist/main.js

@@ -5,7 +5,7 @@ import {
   cancel as cancel3,
   confirm,
   intro,
-  log as log5,
+  log as log4,
   note,
   outro,
   select as select2,
@@ -179,7 +179,7 @@ var OFFICIAL_SAMPLE_ANSWER_KEYS = [
 var OfficialSample = class extends FeatureOption {
   constructor() {
     super({
-      promptHint: "Exactly obsidianmd/obsidian-sample-plugin, with your plugin's id, name, author and description filled in",
+      promptHint: "Exactly obsidianmd/obsidian-sample-plugin, with your plugin's id, name, author, description and license holder filled in",
       promptLabel: "Official sample plugin",
       settingValue: OFFICIAL_SAMPLE_PRESET
     });
@@ -2555,26 +2555,8 @@ function getPluginShortName(pluginId) {
   return pluginId.split("-").map((word) => (word[0] ?? "").toUpperCase() + word.slice(1)).join("");
 }
 
-// src/answers/deprecated-answers.ts
-import { log as log2 } from "@clack/prompts";
-var DEPRECATED_ANSWER_VALUES = {
-  preset: {
-    enhanced: "all-in-one"
-  }
-};
-function resolveDeprecatedAnswer(key, value, source) {
-  const replacement = DEPRECATED_ANSWER_VALUES[key]?.[value];
-  if (replacement === void 0) {
-    return value;
-  }
-  log2.warn(`${key} "${value}" in ${source} is deprecated and was read as "${replacement}". Use "${replacement}" instead.`);
-  return replacement;
-}
-
 // src/answers/cli-args.ts
 var COMPUTED_ANSWER_KEYS = ["currentYear"];
-var DERIVED_TEMPLATE_KEYS = ["pluginShortName"];
-var REFUSED_KEYS = [...COMPUTED_ANSWER_KEYS, ...DERIVED_TEMPLATE_KEYS];
 var ANSWERS_FILE_PREFIX = "--answersFile=";
 var CUSTOM_TEMPLATE_PREFIX = "--customTemplate=";
 var MODE_PREFIX = "--mode=";
@@ -2612,7 +2594,11 @@ function getAnswerableKeys() {
 }
 function getHelpText() {
   const lines = [
-    "Usage: npm create @mnaoumov/obsidian-plugin [-- <options>]",
+    'Usage: npm create @mnaoumov/obsidian-plugin ["--" <options>]',
+    "",
+    'npm needs the "--" before the options; pnpm, yarn and bun do not. Keep its quotes: PowerShell',
+    "swallows a bare --. See https://mnaoumov.dev/create-obsidian-plugin/guides/powershell-separator/",
+    "Full documentation: https://mnaoumov.dev/create-obsidian-plugin/",
     "",
     "Options:",
     "  -y, --yes                 Take every default and skip the post-scaffold prompts. Never asks:",
@@ -2677,7 +2663,7 @@ function parseCliArgs(argv) {
     }
     const [rawKey, rawValue] = splitFlag(argument);
     const key = toAnswerKey(rawKey);
-    flagAnswers[key] = resolveAnswer(key, rawValue, `--${key}`);
+    flagAnswers[key] = resolveAnswer(key, rawValue);
   }
   const fileAnswers = answersFilePath === null ? {} : readAnswersFile(answersFilePath);
   const isOfficialSample = isOfficialSamplePreset(flagAnswers.preset ?? fileAnswers.preset);
@@ -2696,13 +2682,12 @@ function parseCliArgs(argv) {
     useDefaults
   };
 }
-function resolveAnswer(key, value, source) {
-  const resolved = resolveDeprecatedAnswer(key, value, source);
-  assertValidAnswer(key, resolved);
-  return resolved;
+function resolveAnswer(key, value) {
+  assertValidAnswer(key, value);
+  return value;
 }
 function toAnswerKey(key) {
-  if (REFUSED_KEYS.includes(key)) {
+  if (COMPUTED_ANSWER_KEYS.includes(key)) {
     throw new Error(`${key} is computed by the generator, not answered, so it cannot be set.`);
   }
   const answerable = getAnswerableKeys();
@@ -2757,14 +2742,14 @@ function readAnswersFile(path) {
   const source = typeof wrapped === "object" && wrapped !== null ? wrapped : record;
   const answers = {};
   for (const [rawKey, value] of Object.entries(source)) {
-    if (REFUSED_KEYS.includes(rawKey)) {
+    if (COMPUTED_ANSWER_KEYS.includes(rawKey)) {
       continue;
     }
     if (typeof value !== "string") {
       throw new Error(`${rawKey} in ${path} should be a string, got ${typeof value}.`);
     }
     const key = toAnswerKey(rawKey);
-    answers[key] = resolveAnswer(key, value, path);
+    answers[key] = resolveAnswer(key, value);
   }
   return answers;
 }
@@ -2883,7 +2868,7 @@ function validatePluginIdIsUnlisted(pluginId, listedIds) {
 import { join as join5 } from "node:path";
 
 // src/templates.ts
-import { log as log4 } from "@clack/prompts";
+import { log as log3 } from "@clack/prompts";
 import ejs from "ejs";
 import { createHash } from "node:crypto";
 import {
@@ -3165,7 +3150,7 @@ function walkFiles(root, relativeDir) {
 }
 
 // src/versions.ts
-import { log as log3 } from "@clack/prompts";
+import { log as log2 } from "@clack/prompts";
 import {
   maxSatisfying,
   minVersion,
@@ -3468,7 +3453,7 @@ async function resolveVersions(dependencies) {
     }
     resolved.set(packageName, resolution.spec);
     if (resolution.heldBelow !== null) {
-      log3.info(`Holding ${packageName} on ${resolution.spec}, the range ${resolution.heldBy ?? ""} declares, rather than the latest ${resolution.heldBelow}.`);
+      log2.info(`Holding ${packageName} on ${resolution.spec}, the range ${resolution.heldBy ?? ""} declares, rather than the latest ${resolution.heldBelow}.`);
     }
   }
   for (const constrainer of CONSTRAINING_PACKAGES) {
@@ -3493,7 +3478,7 @@ async function resolveVersions(dependencies) {
     record(rest[index] ?? "", resolution);
   }
   if (failed.length > 0) {
-    log3.warn(`Could not look up the latest version of ${failed.join(", ")}. Falling back to "${FALLBACK_VERSION}".`);
+    log2.warn(`Could not look up the latest version of ${failed.join(", ")}. Falling back to "${FALLBACK_VERSION}".`);
   }
   return resolved;
 }
@@ -3802,10 +3787,7 @@ function loadConfig(dir) {
   if (!existsSync4(configPath)) {
     return null;
   }
-  const parsed = JSON.parse(readFileSync3(configPath, "utf-8"));
-  const raw = parsed;
-  migrateAnswers(raw);
-  return parsed;
+  return JSON.parse(readFileSync3(configPath, "utf-8"));
 }
 function pinPresetAnswers(answers) {
   return answers.preset === "demo" ? { ...answers, ...DEMO_PINNED_ANSWERS } : answers;
@@ -3947,25 +3929,25 @@ function importedModule(block) {
 }
 function logUpdateSummary(updated, created, skipped) {
   if (updated.length > 0) {
-    log4.success(`Updated ${String(updated.length)} file(s):`);
+    log3.success(`Updated ${String(updated.length)} file(s):`);
     for (const f of updated) {
-      log4.info(`  ${f}`);
+      log3.info(`  ${f}`);
     }
   }
   if (created.length > 0) {
-    log4.success(`Created ${String(created.length)} new file(s):`);
+    log3.success(`Created ${String(created.length)} new file(s):`);
     for (const f of created) {
-      log4.info(`  ${f}`);
+      log3.info(`  ${f}`);
     }
   }
   if (skipped.length > 0) {
-    log4.warn(`Skipped ${String(skipped.length)} file(s) with local modifications:`);
+    log3.warn(`Skipped ${String(skipped.length)} file(s) with local modifications:`);
     for (const f of skipped) {
-      log4.info(`  ${f}`);
+      log3.info(`  ${f}`);
     }
   }
   if (updated.length === 0 && created.length === 0) {
-    log4.info("Everything is already up to date.");
+    log3.info("Everything is already up to date.");
   }
 }
 function matchesRender(currentHash, newHash, projectFormatter, destinationPath, rendered) {
@@ -3978,64 +3960,6 @@ function matchesRender(currentHash, newHash, projectFormatter, destinationPath,
   const formatted = projectFormatter.formatContent(destinationPath, rendered);
   return formatted !== null && sha256(formatted) === currentHash;
 }
-function migrateAnswers(raw) {
-  const answers = raw["answers"];
-  if (!answers) {
-    return;
-  }
-  if (answers["framework"] && !answers["uiFramework"]) {
-    answers["uiFramework"] = answers["framework"];
-    delete answers["framework"];
-  }
-  if (answers["cssMode"] && !answers["styling"]) {
-    answers["styling"] = answers["cssMode"];
-    delete answers["cssMode"];
-  }
-  if (answers["buildSystem"] && !answers["bundler"]) {
-    answers["bundler"] = answers["buildSystem"];
-    delete answers["buildSystem"];
-  }
-  answers["defaultBranch"] ??= "master";
-  migrateFundingAnswers(answers);
-  answers["fundingUsername"] ??= answers["authorGitHubName"];
-  answers["coverageBadge"] ??= "none";
-  delete answers["pluginShortName"];
-  for (const [key, value] of Object.entries(answers)) {
-    if (typeof value === "string") {
-      answers[key] = resolveDeprecatedAnswer(key, value, CONFIG_FILE_NAME);
-    }
-  }
-}
-function migrateFundingAnswers(answers) {
-  if (answers["fundingPlatform"] !== void 0) {
-    return;
-  }
-  delete answers["gitHubFunding"];
-  const url = typeof answers["fundingUrl"] === "string" ? answers["fundingUrl"] : "";
-  if (!url) {
-    answers["fundingPlatform"] = "none";
-    answers["fundingUrl"] = "";
-    return;
-  }
-  function stripWww(value) {
-    return value.replace("://www.", "://");
-  }
-  for (const option of FUNDING_PLATFORM_OPTIONS) {
-    const prefix = stripWww(option.getUrl({ fundingUrl: "", fundingUsername: "" }));
-    const normalizedUrl = stripWww(url);
-    if (!prefix || !normalizedUrl.startsWith(prefix)) {
-      continue;
-    }
-    const handle = normalizedUrl.slice(prefix.length).replace(/\/$/, "");
-    if (!validateFundingUsername(handle)) {
-      answers["fundingPlatform"] = option.settingValue;
-      answers["fundingUsername"] = handle;
-      answers["fundingUrl"] = "";
-      return;
-    }
-  }
-  answers["fundingPlatform"] = "custom";
-}
 function sha256(content) {
   return createHash("sha256").update(content).digest("hex");
 }
@@ -4163,6 +4087,10 @@ function applyOfficialSampleIdentity(files, answers) {
   if (readme) {
     result.set("README.md", Buffer.from(readme.toString("utf-8").replace(/^# .*$/m, `# ${answers.pluginName}`), "utf-8"));
   }
+  const license = result.get("LICENSE");
+  if (license) {
+    result.set("LICENSE", Buffer.from(license.toString("utf-8").replace(/^Copyright \(C\) [^\r\n]*/m, getOfficialSampleCopyrightLine(answers)), "utf-8"));
+  }
   return result;
 }
 function copyOfficialSample(answers, targetDir, currentVersion, existingConfig, snapshot) {
@@ -4175,6 +4103,9 @@ function copyOfficialSample(answers, targetDir, currentVersion, existingConfig,
   );
   return { ...config, upstreamCommit: snapshot.commit };
 }
+function getOfficialSampleCopyrightLine(answers) {
+  return `Copyright (C) ${String(answers.currentYear)} by ${answers.authorName}`;
+}
 function getPackageRoot() {
   return join5(getScriptDir(), "..");
 }
@@ -4579,7 +4510,7 @@ function buildSavedConfig(newConfig, answers, overlay, targetDir) {
 async function checkForUpdates(currentVersion) {
   const latestVer = await fetchLatestVersion("@mnaoumov/create-obsidian-plugin");
   if (latestVer !== null && compare(currentVersion, latestVer) < 0) {
-    log5.warn(`Your version is outdated. Latest: ${latestVer}. Update with:
+    log4.warn(`Your version is outdated. Latest: ${latestVer}. Update with:
   npm install -g @mnaoumov/create-obsidian-plugin`);
   }
 }
@@ -4607,7 +4538,7 @@ async function ensurePluginIdIsUnlisted(answers, useDefaults) {
   const listedIds = await fetchCommunityPluginIds();
   if (listedIds === null) {
     s.stop("Could not check the plugin id against the Community directory.");
-    log5.warn(`Could not fetch community-plugins.json, so "${answers.pluginId}" was not checked for a collision with a published plugin. The directory rejects a duplicate id, and an id can never be changed once published: check it by hand before submitting.`);
+    log4.warn(`Could not fetch community-plugins.json, so "${answers.pluginId}" was not checked for a collision with a published plugin. The directory rejects a duplicate id, and an id can never be changed once published: check it by hand before submitting.`);
     return answers;
   }
   const collision = validatePluginIdIsUnlisted(answers.pluginId, listedIds);
@@ -4620,7 +4551,7 @@ async function ensurePluginIdIsUnlisted(answers, useDefaults) {
     exitWithUsageError(`${collision}.
 Pass --pluginId=<value> to choose another.`);
   }
-  log5.warn(collision);
+  log4.warn(collision);
   const choice = await select2({
     initialValue: "reenter",
     message: `What should happen to "${answers.pluginId}"?`,
@@ -4751,13 +4682,13 @@ async function offerAnswersExport(answers, customTemplate) {
       if (shell === "sh") {
         chmodSync(scriptPath, SCRIPT_MODE);
       }
-      log5.success(`Wrote ${scriptName}`);
+      log4.success(`Wrote ${scriptName}`);
       note(formatCreateCommand(answers, shell, customTemplate), "Non-interactive command");
     } else {
       writeFileSync2(join9(process.cwd(), answersFileName), formatAnswersJson(answers));
-      log5.success(`Wrote ${answersFileName}`);
+      log4.success(`Wrote ${answersFileName}`);
       const overlayFlag = customTemplate ? ` --customTemplate=${customTemplate}` : "";
-      note(`npm create @mnaoumov/obsidian-plugin -- --yes --mode=create --answersFile=${answersFileName}${overlayFlag}`, "Non-interactive command");
+      note(`npm create @mnaoumov/obsidian-plugin "--" --yes --mode=create --answersFile=${answersFileName}${overlayFlag}`, "Non-interactive command");
     }
     choice = await ask();
   }
@@ -4786,7 +4717,7 @@ async function resolveOfficialSampleSnapshot(latest) {
     return snapshot;
   } catch (error) {
     s.stop(`Could not fetch ${upstream.repo}.`);
-    log5.warn(`${error instanceof Error ? error.message : String(error)}
+    log4.warn(`${error instanceof Error ? error.message : String(error)}
 Using the snapshot this release vendored, ${vendored.commit.slice(0, SHORT_SHA_LENGTH)}.`);
     return vendored;
   }
@@ -4890,7 +4821,7 @@ async function runPostScaffold(targetDir, answers) {
     } catch (error) {
       s.stop(`Failed to install dependencies. Run \`${installCmd}\` manually.`);
       if (error instanceof Error && "stderr" in error) {
-        log5.error(String(error.stderr));
+        log4.error(String(error.stderr));
       }
     }
   }
@@ -4914,7 +4845,7 @@ async function runPostScaffold(targetDir, answers) {
     } catch (error) {
       s.stop("Failed to initialize git. Run `git init` manually.");
       if (error instanceof Error && "stderr" in error) {
-        log5.error(String(error.stderr));
+        log4.error(String(error.stderr));
       }
     }
   }
@@ -4940,10 +4871,10 @@ async function runUpdate(currentVersion, cliArgs) {
   const targetDir = process.cwd();
   const existingConfig = loadConfig(targetDir);
   if (!existingConfig) {
-    log5.error("No config file found. Cannot update.");
+    log4.error("No config file found. Cannot update.");
     process.exit(1);
   }
-  log5.info(`Current project was generated with v${existingConfig.generatorVersion}`);
+  log4.info(`Current project was generated with v${existingConfig.generatorVersion}`);
   let overlay = null;
   if (customTemplate !== void 0) {
     overlay = customTemplate ? loadOverlayOrExit(resolvePath(customTemplate)) : null;
@@ -4953,14 +4884,14 @@ async function runUpdate(currentVersion, cliArgs) {
       `
 This project records it in ${CONFIG_FILE_NAME}. Pass --customTemplate=<dir> to point at where it is now, or --customTemplate= to stop using it.`
     );
-    log5.info(`Applying the custom template recorded for this project: ${existingConfig.customTemplate}`);
+    log4.info(`Applying the custom template recorded for this project: ${existingConfig.customTemplate}`);
   }
   const configPath = join9(targetDir, CONFIG_FILE_NAME);
   const savedConfig = JSON.parse(readFileSync8(configPath, "utf-8"));
   let answers;
   if (savedConfig.answers) {
     const saved = { ...savedConfig.answers, ...suppliedAnswers };
-    log5.info("Using saved answers from previous generation.");
+    log4.info("Using saved answers from previous generation.");
     const shouldRePrompt = useDefaults ? false : await confirm({
       initialValue: false,
       message: "Would you like to change any settings?"
@@ -4976,7 +4907,7 @@ This project records it in ${CONFIG_FILE_NAME}. Pass --customTemplate=<dir> to p
       exitWithUsageError(`${CONFIG_FILE_NAME} records no answers, so --yes has none to reuse.
 Run without --yes to answer them again.`);
     }
-    log5.warn("No saved answers found. Please provide the settings again.");
+    log4.warn("No saved answers found. Please provide the settings again.");
     answers = await promptAnswers(suppliedAnswers);
   }
   const savedPluginId = savedConfig.answers?.pluginId;
@@ -4998,7 +4929,7 @@ Run without --yes to answer them again.`);
   const { minAppVersion, resolvedVersions } = await resolveExternalVersions(answers, overlay);
   const projectFormatter = createProjectFormatter(targetDir, answers.formatter);
   if (projectFormatter === null && needsInitialFormat(answers.formatter)) {
-    log5.warn(`${answers.formatter} is not installed, so the update cannot tell the files it formatted from hand edits and skips them. Install the dependencies and update again to have them updated.`);
+    log4.warn(`${answers.formatter} is not installed, so the update cannot tell the files it formatted from hand edits and skips them. Install the dependencies and update again to have them updated.`);
   }
   const s = spinner();
   s.start("Updating project files...");

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@mnaoumov/create-obsidian-plugin",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Create Obsidian plugin from modern templates.",
-  "homepage": "https://github.com/mnaoumov/create-obsidian-plugin#readme",
+  "homepage": "https://mnaoumov.dev/create-obsidian-plugin/",
   "bugs": "https://github.com/mnaoumov/create-obsidian-plugin/issues",
   "repository": {
     "type": "git",
@@ -27,6 +27,9 @@
   "scripts": {
     "build": "jiti scripts/build.ts",
     "commit": "jiti scripts/commit.ts",
+    "docs:build": "jiti scripts/docs-build.ts",
+    "docs:dev": "jiti scripts/docs-dev.ts",
+    "docs:preview": "jiti scripts/docs-preview.ts",
     "format": "jiti scripts/format.ts",
     "format:check": "jiti scripts/format-check.ts",
     "gate:case": "jiti scripts/gate-one-case.ts",
@@ -57,24 +60,28 @@
     "typescript": "$typescript"
   },
   "dependencies": {
-    "@clack/core": "^1.4.3",
-    "@clack/prompts": "^1.7.0",
+    "@clack/core": "^1.5.1",
+    "@clack/prompts": "^1.8.1",
     "ejs": "^6.0.1",
     "semver": "^7.8.5"
   },
   "devDependencies": {
+    "@astrojs/markdown-satteri": "^0.4.6",
+    "@astrojs/starlight": "^0.42.8",
     "@commitlint/cli": "^21.2.2",
     "@commitlint/config-conventional": "^21.2.2",
     "@commitlint/types": "^21.2.0",
     "@eslint-community/eslint-plugin-eslint-comments": "^4.7.2",
     "@eslint/js": "^10.0.1",
     "@mnaoumov/typescript-dev-toolkit": "^5.2.0",
+    "@resvg/resvg-js": "^2.6.2",
     "@stylistic/eslint-plugin": "^5.10.0",
     "@total-typescript/ts-reset": "^0.6.1",
     "@tsconfig/strictest": "^2.0.8",
     "@types/ejs": "^3.1.5",
     "@types/semver": "^7.8.0",
     "@vitest/coverage-v8": "^5.0.5",
+    "astro": "^7.4.4",
     "better-typescript-lib": "^2.12.0",
     "cspell": "^10.1.1",
     "czg": "^1.14.0",
@@ -88,6 +95,8 @@
     "husky": "^9.1.7",
     "ignore": "^7.0.12",
     "jiti": "^2.7.0",
+    "satori": "^0.33.5",
+    "satteri": "^0.10.5",
     "typescript": "6.0.3",
     "typescript-eslint": "^8.68.0",
     "vitest": "^5.0.5",

package/src/main.ts

@@ -417,7 +417,8 @@ async function offerAnswersExport(answers: Answers, customTemplate: string | und
       writeFileSync(join(process.cwd(), answersFileName), formatAnswersJson(answers));
       log.success(`Wrote ${answersFileName}`);
       const overlayFlag = customTemplate ? ` --customTemplate=${customTemplate}` : '';
-      note(`npm create @mnaoumov/obsidian-plugin -- --yes --mode=create --answersFile=${answersFileName}${overlayFlag}`, 'Non-interactive command');
+      // `"--"` is quoted so the command works pasted into PowerShell, which swallows a bare `--`, as well as cmd and sh.
+      note(`npm create @mnaoumov/obsidian-plugin "--" --yes --mode=create --answersFile=${answersFileName}${overlayFlag}`, 'Non-interactive command');
     }
 
     choice = await ask();