generator-obsidian-plugin

> Obsidian Plugin Yeoman Generator

Installation

For template generator to be fully working it requires Node.js v18 or higher.

First, install Yeoman and generator-obsidian-plugin using npm (we assume you have pre-installed node.js).

npm install -g yo
npm install -g generator-obsidian-plugin

Then generate your new project:

yo obsidian-plugin

Features of this template

• Enables unofficial TypeScript typings to the internal Obsidian API.
• Code style is forced via ESLint.
• Spell checking is forced via CSpell.
• Uses CLI commands and code helpers from Obsidian Dev Utils.

NPM Commands

The package offers several NPM commands to facilitate common development tasks:

Build Production Version

npm run build

Compiles the production version of your plugin into the dist/build folder.

Build Development Version

npm run dev

Compiles the development version of your plugin into the dist/dev folder. The OBSIDIAN_CONFIG_DIR can be set either as an environment variable or specified in a .env file (e.g., path/to/my/vault/.obsidian). The command automatically copies the compiled plugin to the specified Obsidian configuration directory and triggers the [Hot Reload] plugin, if it is enabled. If the [Hot Reload] plugin is not installed, it will be installed automatically, and you will need to enable it manually.

Lint Code

npm run lint

Lints your code, enforcing a code convention to minimize common errors.

Lint and Fix Code

npm run lint:fix

Lints your code and automatically applies fixes where possible.

Spellcheck Code

npm run spellcheck

Checks your code for spelling errors.

Version Management

npm run version 

Runs build checks before updating the version and releases if all checks pass. The `` can be major, minor, patch, beta, or a specific version like x.y.z[-suffix].

Support

License

© Michael Naumov