A universal CLI tool for creating and managing cron task management platforms.
npx @alex-programmer/cron create my-cron-project
cd my-cron-project
npm install
npm run devcd your-cron-project
npx @alex-programmer/cron upgradeThe generated project includes:
- ✅ Modern Web Interface: Built with Next.js and Ant Design
- ⏰ Flexible Scheduling: Support for various cron expressions (every second/minute/hour/day/month)
- 🔄 Task Management: Pause, resume, and test tasks with real-time feedback
- 📊 Execution Monitoring: Comprehensive logs and statistics
- 🎯 Task Categories: Business tasks and Keep Alive monitoring
- 🔧 HTTP Configuration: Custom headers and request body support
- 💾 Data Persistence: SQLite database with environment-specific storage
- 📱 Responsive Design: Works on mobile and desktop
- 🚀 Easy Deployment: Ready for production deployment
Creates a new cron task management project.
Options:
-t, --template <template>: Template to use (default: "default")
Example:
npx @alex-programmer/cron create my-scheduler
npx @alex-programmer/cron create my-scheduler --template defaultUpgrades an existing project to the latest version while preserving your data and configurations.
Options:
-f, --force: Force upgrade without confirmation
Example:
npx @alex-programmer/cron upgrade
npx @alex-programmer/cron upgrade --force- ✅ SQLite database files (
cron_tasks.db,data/cron_tasks.db) - ✅ Environment files (
.env,.env.local,.env.production) - ✅ Project name and custom package.json configurations
- ✅ Any custom data you've added
- 🔄 Core application files (
app/,components/,lib/,types/) - 🔄 Configuration files (
next.config.ts,tsconfig.json, etc.) - 🔄 Dependencies in
package.json - 🔄 Build scripts and tooling
After creating a project, you'll get:
my-cron-project/
├── app/ # Next.js app directory
│ ├── api/ # API routes for task management
│ ├── globals.css # Global styles
│ ├── layout.tsx # Root layout
│ └── page.tsx # Main dashboard
├── components/ # React components
│ ├── TaskForm.tsx # Task creation/editing form
│ └── TaskLogs.tsx # Execution logs display
├── lib/ # Core libraries
│ ├── cronManager.ts # Task scheduling engine
│ ├── cronUtils.ts # Cron expression utilities
│ ├── database.ts # SQLite database layer
│ └── startup.ts # Application initialization
├── types/ # TypeScript definitions
├── public/ # Static assets
├── .cron-version # Version tracking for upgrades
└── package.json # Project configuration
The platform uses SQLite for data persistence:
- Development:
cron_tasks.dbin project root - Production:
data/cron_tasks.db(configurable via environment)
This is an open-source project. Contributions are welcome!
MIT
Need help? Open an issue on GitHub or check the documentation in your generated project.