Mirrors/super-productivity
1
0
Fork 0
mirror of https://github.com/johannesjo/super-productivity.git synced 2026-07-19 01:17:31 +00:00
Code Issues Projects Releases Wiki Activity
super-productivity/packages
History
Johannes Millan 75180a0602 feat(supersync): add operational procedures documentation 
Complete minimal operational documentation for encrypted deployment:

Daily Operations:
- Server startup procedure (unlock → start → verify)
- Common issues and solutions table

Backup Procedures:
- Creating backups (daily recommended)
- Backup rotation (7d/4w/12m retention)
- Restoring from backup (disaster recovery)

Monitoring:
- Daily health checks (service status, connectivity, disk usage)
- Weekly checks (backup verification, LUKS status)
- Performance baseline establishment

Emergency Procedures:
- Using recovery passphrase
- LUKS header corruption recovery
- Full system failure rollback

Troubleshooting Guide:
- PostgreSQL won't start (4-step diagnosis)
- Slow performance (AES-NI, disk I/O)
- Disk space issues (expand volume)

Scheduled Tasks:
- Recommended cron jobs (backup, rotation, health reports)

Security Best Practices:
- Passphrase management
- Audit trail review
- Access control

Quick reference with essential commands for daily operations.

This completes Phase 5 essentials - system is ready for testing.
2026-01-23 14:31:24 +01:00
..
plugin-api fix(sync): restore missing force upload button in new config UI 2026-01-19 13:58:23 +01:00
plugin-dev chore(deps): bump the npm_and_yarn group across 5 directories with 1 update 2026-01-21 23:25:54 +00:00
shared-schema fix(migrations): ensure unique IDs and prevent data loss in split operations 2026-01-20 17:07:23 +01:00
super-sync-server feat(supersync): add operational procedures documentation 2026-01-23 14:31:24 +01:00
vite-plugin feat(plugins): add i18n support to boilerplate-solid-js 2026-01-16 22:34:50 +01:00
build-packages.js fix(build): add shared-schema to prepare script for CI builds 2026-01-11 16:11:36 +01:00
README.md feat: cleanup and update plugins 2 2025-06-29 06:36:02 +02:00

README.md

Super Productivity Packages

This directory contains plugin packages and the plugin API for Super Productivity.

Structure

  • plugin-api/ - TypeScript definitions for the plugin API
  • plugin-dev/ - Plugin development examples and tools
    • api-test-plugin/ - Basic API test plugin
    • procrastination-buster/ - Example SolidJS-based plugin
    • yesterday-tasks-plugin/ - Simple plugin showing yesterday's tasks
    • boilerplate-solid-js/ - Template for creating new SolidJS plugins (not built)
    • sync-md/ - Markdown sync plugin (not built)

Building Packages

All packages are built automatically when running the main build process:

npm run build:packages

This command:

  1. Builds the plugin-api TypeScript definitions
  2. Builds plugins that require compilation (e.g., procrastination-buster)
  3. Copies plugin files to src/assets/ for inclusion in the app

Development

To work on a specific plugin:

cd plugin-dev/[plugin-name]
npm install
npm run dev

Adding a New Plugin

  1. Create a new directory in plugin-dev/
  2. Add the plugin configuration to /packages/build-packages.js
  3. Run npm run build:packages to test the build

Notes

  • The boilerplate-solid-js and sync-md plugins are development templates and are not included in production builds
  • Plugin files are automatically copied to src/assets/ during the build process
  • The build script handles dependency installation automatically