super-productivity/packages/plugin-dev/QUICK_START.md
Johannes Millan d4d81bf511 feat(plugin-api): create foundational plugin API package
- Add @super-productivity/plugin-api package with TypeScript definitions
- Define core plugin interfaces, types, and manifest structure
- Add plugin hooks system for event-driven architecture
- Create plugin API type definitions and constants
- Add documentation and development guidelines
2025-06-27 18:13:19 +02:00

1.1 KiB

Plugin Development Quick Start

Option 1: Plain JavaScript (Simplest)

cd minimal-plugin
# Edit plugin.js
# Zip the files and upload

Pros: No build step, instant feedback Cons: No TypeScript, no bundling

cd simple-typescript-plugin
npm install
npm run build
# Find plugin.zip in dist/

Pros: TypeScript support, simple build Cons: Limited to single file

Option 3: Full TypeScript + Webpack (Advanced)

cd example-plugin
npm install
npm run build
npm run package

Pros: Multiple files, full tooling Cons: More complex setup

Which Should I Use?

  • Just testing? → Use minimal-plugin
  • Want TypeScript? → Use simple-typescript-plugin
  • Building complex plugin? → Use example-plugin

Development Tips

  1. Start with minimal-plugin to understand the API
  2. Move to TypeScript when you need type safety
  3. Only use webpack if you need multiple source files

Testing Your Plugin

  1. Copy files to src/assets/my-plugin/ for local testing
  2. Or zip and upload via Settings → Plugins

That's it! 🚀