{"_id":"@acidop/coldstart","name":"@acidop/coldstart","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@acidop/coldstart","version":"1.0.0","description":"CLI tool to keep your services warm and prevent cold starts","main":"dist/index.js","bin":{"coldstart":"dist/index.js"},"scripts":{"build":"tsc","start":"npm run build && node dist/index.js","dev":"ts-node src/index.ts","prepare":"npm run build"},"keywords":["cold-start","warmup","keep-alive","serverless","cli"],"author":{"name":"Acid-OP"},"license":"MIT","dependencies":{"axios":"^1.6.0","chalk":"^4.1.2","inquirer":"^8.2.5","ora":"^5.4.1"},"devDependencies":{"@types/inquirer":"^9.0.9","@types/node":"^20.19.31","ts-node":"^10.9.2","typescript":"^5.9.3"},"engines":{"node":">=14.0.0"},"gitHead":"eeb52bc0ed12a8e0d586b58a839e1fea0d1a7491","types":"./dist/index.d.ts","_id":"@acidop/coldstart@1.0.0","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-N8rhw/DNsB3gWZdHsozbMY6E5tUD0QASyT03y0Cw0/mhvQ8cyoBFsEE66m+jAc/6b4nodrpP9TFQfPS+W0ge0w==","shasum":"182dcb653110d4f0d4b29ae9c9076430a0278272","tarball":"https://registry.npmjs.org/@acidop/coldstart/-/coldstart-1.0.0.tgz","fileCount":34,"unpackedSize":49762,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGym1Z86Yo8MRJyaGP/TFjwNKRIIp9oNjVaEjlb9Ys4CAiB0d8gzD95dQ4NtuRpbIfIeUPqtnsaDSXHfj5TT9WMk2g=="}]},"_npmUser":{"name":"acidop","email":"gauravkapur596@gmail.com"},"directories":{},"maintainers":[{"name":"acidop","email":"gauravkapur596@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/coldstart_1.0.0_1770370714256_0.24332341579080352"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-06T09:38:34.196Z","1.0.0":"2026-02-06T09:38:34.386Z","modified":"2026-02-06T09:38:34.537Z"},"maintainers":[{"name":"acidop","email":"gauravkapur596@gmail.com"}],"description":"CLI tool to keep your services warm and prevent cold starts","keywords":["cold-start","warmup","keep-alive","serverless","cli"],"author":{"name":"Acid-OP"},"license":"MIT","readme":"# Coldstart\n\n> Keep your services warm and prevent cold starts before demos, interviews, and presentations.\n\n## The Problem\n\nServerless platforms and free-tier hosting (Render, Heroku, Railway, etc.) spin down services after inactivity. When someone visits, the service takes 30-60 seconds to cold start - loading dependencies, establishing connections, and initializing.\n\nThis causes issues during:\n- Job interviews\n- Client demos\n- Hackathon presentations\n- Live showcases\n\n## The Solution\n\n**Coldstart** wakes up your services and keeps them warm by sending regular HTTP requests. Simple, effective, zero configuration needed.\n\n---\n\n## Quick Start\n\n```bash\nnpx coldstart\n```\n\nThat's it. The CLI will guide you through the rest.\n\n---\n\n## Features\n\n- **Interactive CLI** - Answer a few questions, done\n- **Multi-service support** - Wake up your frontend, backend, WebSocket servers, all at once\n- **HTTP & WebSocket detection** - Automatically handles different server types\n- **Keep-alive mode** - Continuously ping services every 5 minutes\n- **Parallel warmup** - All services wake up simultaneously\n- **Beautiful output** - Real-time progress with spinners and status updates\n\n---\n\n## How It Works\n\n### Step 1: Configuration\n```\n? How many services? 3\n? Name: Frontend\n? URL: https://myapp.com\n? Type: HTTP Server\n```\n\n### Step 2: Warmup Process\nThe CLI runs through three stages:\n\n1. **Wake** - Sends initial requests to all services\n2. **Initialize** - Waits 20 seconds for dependencies to load\n3. **Verify** - Confirms services are stable with multiple checks\n\n### Step 3: Keep-Alive (Optional)\n```\n? Enable keep-alive mode? Yes\n\n♻️  Keep-Alive Mode\n  Pinging every 5 minutes\n  Press Ctrl+C to stop\n```\n\nYour services stay warm as long as the script runs.\n\n---\n\n## Usage Examples\n\n### Basic Usage\n```bash\nnpx coldstart\n```\n\n### Multiple Services\nPerfect for microservices architecture:\n- Frontend (React/Next.js)\n- Backend API (Node.js/Python)\n- WebSocket server\n- Database proxy\n\n### Before Important Events\nRun 5 minutes before your:\n- Technical interviews\n- Client presentations\n- Demo day pitches\n- Hackathon judging\n\n---\n\n## Status Codes\n\n**HTTP Servers**\n- `200`, `301`, `302`, `304` = Ready ✓\n\n**WebSocket Servers**\n- `426` (Upgrade Required) = Ready ✓\n- `101` (Switching Protocols) = Ready ✓\n\n---\n\n## Requirements\n\n- Node.js 14 or higher\n- Services must be publicly accessible (HTTPS/HTTP)\n\n---\n\n## Why This Works\n\nServerless and free-tier platforms shut down services to save resources. A simple HTTP request forces them to wake up. By pinging regularly, they never go back to sleep.\n\n**Technical Details:**\n- Uses `axios` for HTTP requests\n- 30-second timeout per request\n- Parallel execution with Promise.all\n- Handles both HTTP and WebSocket protocols\n\n---\n\n## Installation\n\n**As a one-off command (recommended):**\n```bash\nnpx coldstart\n```\n\n**Global installation:**\n```bash\nnpm install -g coldstart\ncoldstart\n```\n\n---\n\n## Development\n\n```bash\n# Clone repository\ngit clone https://github.com/Acid-OP/coldstart.git\ncd coldstart\n\n# Install dependencies\nnpm install\n\n# Run in development mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Test locally\nnpm link\ncoldstart\n```\n\n---\n\n## License\n\nMIT © [Acid-OP](https://github.com/Acid-OP)\n\n---\n\n## Contributing\n\nIssues and pull requests welcome. Keep it simple.\n\n---\n\n**Built for developers who need their services ready when it matters.**\n","readmeFilename":"README.md","_rev":"1-c93b6a70209bebda4dc5802033daf19d"}