safelaunch v1.0.23 — one command to protect your deploys

Your deploy is going to fail.
We tell you why before you push.

One command scans your project, locks your environment, and blocks bad deploys forever. No setup. No config. Just run it.

Get started free View on GitHub →
2,500+
npm installs
115+
VS Code installs
16
checks
npx safelaunch setup
$ npx safelaunch setup
Scanning your project...
Detected: Next.js

🚨 Safelaunch Scan Report

This project is NOT safe to deploy

3 issues found
2 critical · 1 warning

──────────────

🚨 CRITICAL (will break your app)

1. DATABASE_URL is missing

   Impact:
   Your app cannot use DATABASE_URL
   → Will crash or behave incorrectly

──────────────

⚠️ WARNINGS (may cause issues)

2. .env is not in .gitignore

   Impact:
   → One git add away from leaking secrets

──────────────

✓ What's working (6 checks passed)

Get protected in
one command.

No installation required. Run it in any JavaScript project. Scans for issues, locks your config, and installs a git hook that blocks bad deploys automatically.

npx safelaunch setup
works with Node.js, Next.js, Vite, and Create React App
~/my-app — protected
$ npx safelaunch setup
Running safelaunch setup...
Detected: Vite

✓ All checks passed — setting up...

──────────────

env.manifest.json    ✓ generated
git hook            ✓ installed

──────────────

🏝️ You're protected

   safelaunch validates your env
   before every git push.
How it works

One command.
Zero broken deploys.

Run setup once. safelaunch handles everything else automatically.

STEP 00
Run setup
Zero config. Run it in any JavaScript project. Scans for issues, generates your manifest, and installs the git hook — all in one shot.
npx safelaunch setup
STEP 01
Generate your contract
Scans your entire codebase and generates env.manifest.json — the single source of truth for every variable your app needs.
safelaunch init
STEP 02
Validate your environment
Runs 16 checks against your actual environment. Catches everything that will break production before it gets there.
safelaunch validate
STEP 03
Automate it forever
Install the git hook once. Validation runs automatically before every push. Bad environments never reach production again.
safelaunch hook install
What we catch

16 checks.
Zero surprises.

Every failure mode between your local environment and production.

✗
Missing variables
Required variables that are completely absent from .env. Your app will crash.
all projects
✗
Empty variables
Variables present but with no value. Your app starts then breaks silently.
all projects
✗
.env committed to git
Your secrets are in your git history. Anyone with repo access can see them.
all projects
✗
Hardcoded secrets
API keys or tokens written directly in source files. Gets committed and exposed.
all projects
✗
Dependencies not installed
node_modules missing entirely. Your app will not start.
all projects
✗
Config file missing
next.config.js or vite.config.js missing. Your framework cannot build the project.
next.js · vite
⚠
Duplicate variables
Same key defined twice in .env. The last one wins silently.
all projects
⚠
Dependency drift
Package in package.json but not installed in node_modules.
all projects
⚠
Lockfile missing
No package-lock.json. npm install resolves different versions each time.
all projects
⚠
.env not in .gitignore
One git add away from committing your secrets to version history.
all projects
⚠
.env.example out of sync
Variables in .env missing from .env.example. Teammates won't know they exist.
all projects
⚠
Build script missing
No build script in package.json. Your deploy pipeline won't know how to build.
all projects
⚠
TypeScript errors
Type errors that will fail your CI build. Caught before you push.
all projects
⚠
Uncommitted changes
Changes that won't be included in your deploy. Deploy what you tested.
all projects
⚠
VITE_ prefix
Variables without VITE_ prefix are invisible to the browser in Vite projects.
vite
⚠
REACT_APP_ prefix
Variables without REACT_APP_ prefix won't reach your CRA frontend.
create react app

Start in 30 seconds.

Free forever. Open source. Works with every JavaScript project. No account required.

npx safelaunch setup
VS Code Extension → GitHub → npm →
⚡
Vite
VITE_ prefix checks + import.meta.env scanning
▲
Next.js
NEXT_PUBLIC_ awareness + .env priority conflicts
⚛
Create React App
REACT_APP_ prefix validation + env scanning
🟩
Node.js
Full process.env scanning + runtime checks
🔒 safelaunch runs entirely on your machine. It never sends your environment variables, secrets, or project data to external servers. Your .env files stay local. Always.

Never debug a broken environment again.

One command. Protected forever.

npx safelaunch setup → View source