Open Source CLI Tool • Apache License 2.0

Initialize Node.js & TypeScript backends
with zero friction.

A minimal CLI with full TypeScript support that generates only the essentials — a server, a route, and a lifecycle. Reach a running state in seconds, not minutes.

terminal
$ npx fogoe
No installation required. Run directly with npx. Or install globally with npm i -g fogoe.
2
Languages
2
Frameworks
4
Databases
<30s
To Running Server

How It Works

Three steps to a running backend. No configuration headaches.

1

Run the Command

Execute Fogoe directly using npx. No global installation needed.

npx fogoe
2

Choose Your Stack

Select language (JS/TS), framework, module system, database, and architecture pattern.

TypeScript + Express
3

Start Building

Your project is ready. Server is running. One route is live. Extend as needed.

npm run dev

The Problem

  • Initializing projects manually every time
  • Installing the same base dependencies repeatedly
  • Configuring entry points and boilerplate from scratch
  • "Server is alive" state takes too much time
  • Setup creates friction before real work begins

The Solution

  • Intentionally minimal, clean code generation
  • Fully extensible design — no lock-in
  • Immediate running state with one route
  • Choose your own database and auth approach
  • You control what happens next

What Gets Generated

A clean, minimal structure that you can extend or restructure as needed.

your-project/
  • config/
  • db.js
  • env.js
  • controllers/
  • homecontroller.js
  • functions/
  • helper.js
  • middlewares/
  • models/
  • model.js
  • routes/
  • home.js
  • utils/
  • hashing.js
  • app.js
  • server.js
  • package.json
  • .env

Ready to Run

Server is configured and starts immediately. One health-check route is already live at the root endpoint.

Database Ready

Connection template included for your chosen database. Just add your credentials to .env and connect.

Security Included

CORS configured, environment variables managed with dotenv, and optional bcrypt/argon2 for hashing.

Fully Extensible

No magic, no hidden configurations. Add your own controllers, services, and routes as needed.

Architecture Options

Choose the structure that fits your project scope and team preferences.

LIGHTWEIGHT

Minimal

Single server entry point. Fast startup. No enforced structure. Maximum flexibility.

  • Single file entry point
  • Instant startup
  • Perfect for prototypes
  • Ideal for microservices
STRUCTURED

MVC

Controllers, routes, services, and config directories. Conventional structure for larger projects.

  • Organized folder structure
  • Separation of concerns
  • Best for team projects
  • Scales with your app

Full TypeScript Support

Automatic configuration with zero setup. TypeScript just works out of the box.

Smart Configuration

  • Automatic @types/* package installation
  • Optimized tsconfig.json for your module type
  • Path aliases for MVC projects (@routes/*, @controllers/*)
  • tsx and ts-node included for development

Auto-Installed Types

  • Core: typescript, ts-node, tsx, @types/node
  • Express: @types/express, @types/cors
  • Fastify: @fastify/type-provider-typebox
  • Database & Library types as needed

Git Integration

Optionally initialize a Git repository and push to GitHub during setup.

Automatic .gitignore

Pre-configured with node_modules/ and .env to keep your repository clean.

Initial Commit

All project files committed automatically with a clean initial commit.

GitHub Push

Connects to your repository and pushes the first commit automatically.

Completely Optional

Skip if you prefer manual Git setup. Full control over your workflow.

Git Setup Flow
  • "Initialize Git repository?" → yes
  • Enter branch name (default: main)
  • Provide GitHub repository URL
  • https://github.com/user/repo.git
  • Fogoe handles the rest:
  • git init
  • git add .
  • git commit -m "Initial commit"
  • git push

Commands Reference

Zero-friction workflow to manage your project repository and initialize projects.

npx fogoe / fogoe

The Interactive Initializer. Launches the main setup wizard to scaffold a new Node.js backend project from scratch.

  • Framework & Language selection
  • Database & Authentication
  • Optional Git Initialization

npx fogoe init / fogoe init

Integrates Git into an existing Fogoe project and updates the state config.

  • Initializes local Git repository
  • Connects to remote GitHub branch
  • Pushes the initial commit

npx fogoe push "message" / fogoe push "message"

A complete shortcut command that automatically stages, commits, and pushes your changes to GitHub in one seamless operation.

1. git add .
2. git commit -m "message"
3. git push

Supported Stack

Flexible options to match your preferred development workflow.

Languages JavaScript TypeScript
Frameworks Express Fastify
Module Systems CommonJS ES Modules
Databases MongoDB (Mongoose) Prisma MySQL2 PostgreSQL (pg)
Security bcrypt argon2 cors dotenv
Auth (Optional) jsonwebtoken
Git Integration GitHub Init Auto-commit Auto-push

Philosophy

"Fogoe provides the foundation.
You build the system."

Fogoe scaffolds projects, it does not configure full systems.

Database, authentication, and encryption are opt-in dependencies. No schemas, migrations, or business logic are generated.

No business logic generation
No framework lock-in
No database schemas
No migrations included
No deployment assumptions
No opinionated architecture

Ready to Get Started?

Initialize your next backend project in seconds. No setup, no friction.

View on GitHub
Copied to clipboard