Question 1

How to set up vite-plugin-monkey for a Vue TypeScript userscript?

Accepted Answer

Use the quick start command 'pnpm create monkey' and select the vue-ts template, which sets up a pre-configured project with Vite, Vue, and TypeScript support. Then, run the dev server to get HMR and automatic metadata injection.

Question 2

vite-plugin-monkey vs traditional userscript development: which is better?

Accepted Answer

vite-plugin-monkey is better for complex scripts using modern frameworks and TypeScript, offering HMR and auto-configuration. Traditional methods are simpler for basic scripts but lack these productivity features and tooling integration.

Question 3

How to handle CSP errors when developing with vite-plugin-monkey?

Accepted Answer

The README recommends using the Disable-CSP browser extension during development to bypass CSP restrictions in serve mode. This is a temporary workaround, as the plugin injects scripts that can be blocked by default CSP policies.

Question 4

Can I use vite-plugin-monkey to build userscript libraries for npm?

Accepted Answer

Yes, the README includes a section on building libraries with GM APIs by importing from 'vite-plugin-monkey/dist/client' and configuring builds to exclude or alias it. This allows creating shareable libraries compatible with ESM and @require usage.

Question 5

How to configure external CDN dependencies like React in vite-plugin-monkey?

Accepted Answer

Use the build.externalGlobals option in the plugin config, with utilities like cdn.jsdelivr() to map imports to CDN URLs. For example, React can be set to load from jsDelivr, and the plugin auto-injects @require headers.

Question 6

Does vite-plugin-monkey support all userscript engines like Greasemonkey?

Accepted Answer

Yes, it supports Tampermonkey, Violentmonkey, Greasemonkey, and ScriptCat by generating standard .user.js files. However, note that GreasyFork's no-minification rule may require adjusting build.minify settings.

vite-plugin-monkey

What is vite-plugin-monkey?

Overview

Use Cases

Best For

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions