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

55 lines
1.1 KiB
Markdown

# Plugin Development Quick Start
## Option 1: Plain JavaScript (Simplest)
```bash
cd minimal-plugin
# Edit plugin.js
# Zip the files and upload
```
**Pros:** No build step, instant feedback
**Cons:** No TypeScript, no bundling
## Option 2: Simple TypeScript (Recommended)
```bash
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)
```bash
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! 🚀