Krito ⚡

Krito is a full-stack CLI scaffolding tool that kickstarts modern web apps with an optimized developer experience.

It sets up a project with:

• Frontend: Vite + React + Tailwind CSS + React Router + Axios + Lucide React
• Backend: Express.js + MongoDB (via Mongoose) + Dotenv + CORS + Modular Structure
• Dev Tools: Nodemon (for backend development)

Created by Satyam Rana, Krito helps you avoid repetitive setup and dive straight into building.

Features

• Instant full-stack project setup with one command
• Clean folder structure with frontend and backend
• Pre-configured Tailwind CSS and Vite plugin integration
• React Router and Axios pre-installed
• Express server setup with routing, controllers, models, and config
• MongoDB integration via Mongoose
• Health check endpoint (GET /health)
• .env files for both frontend and backend
• .gitignore auto-generated
• Development-ready tooling like Nodemon
• Graceful error handling and rollback on failure
• SIGINT (Ctrl+C) handling during setup
• Beautiful spinner-based terminal UI
• Zero configuration required

Installation

npm install -g krito

Usage

krito my-app

This creates a new full-stack app named my-app.

Scaffold in Current Directory

mkdir my-app && cd my-app
krito .

Using . creates frontend/ and backend/ directly inside the current directory.

CLI Options

krito --help          # Show help
krito --version       # Show version
krito -v              # Show version (shorthand)
krito <project-name>  # Create a new project
krito .               # Scaffold in current directory

Project Name Rules

• Lowercase letters, numbers, hyphens, dots, underscores, and tildes only
• Cannot start with a dot or underscore
• Must be under 214 characters

Project Structure

my-app/
├── .gitignore
├── frontend/           # React + Vite + Tailwind + React Router + Axios + Lucide
│   ├── src/
│   │   ├── App.jsx
│   │   ├── main.jsx
│   │   └── index.css
│   ├── vite.config.js
│   └── .env
├── backend/            # Express + MongoDB + CORS + Dotenv + Mongoose
│   ├── server.js
│   ├── routes/
│   ├── models/
│   ├── controllers/
│   ├── middleware/
│   ├── config/
│   │   └── dbConfig.js
│   └── .env

Technologies Used

Frontend

• Vite
• React
• Tailwind CSS
• React Router DOM
• Axios
• Lucide React

Backend

• Express.js
• Mongoose (MongoDB ORM)
• Dotenv
• CORS
• Nodemon (Dev tool)

Getting Started

# Create a new project
krito my-app

# Start frontend
cd my-app/frontend
npm run dev

# Start backend (in a separate terminal)
cd my-app/backend
npm run dev

The frontend runs on http://localhost:5173 and the backend on http://localhost:5000.

API Endpoints

| Method | Endpoint | Description | | ------ | --------- | ------------------------ | | GET | / | API is live message | | GET | /health | Health check with uptime |

Requirements

• Node.js >= 18
• npm >= 8
• MongoDB (for backend database)

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

ISC

Author

Satyam Rana Curiosity is the real compiler.