create-craftjs

CraftJS

A starter kit backend framework powered by Express, TypeScript, EJS Engine, and Prisma — designed for rapid development, simplicity, and scalability.

Features

• Express.js based API architecture
• TypeScript support out of the box
• Prisma ORM with scalable database structure
• CLI tool (craft) for project automation
• Built-in Logger, Validation, Error handler, and Request lifecycle
• Predefined project structure for fast onboarding

💡 Note: EJS View Engine is included but disabled by default. To enable it: Open src/application/web.ts and uncomment the following lines:

import expressLayouts from "express-ejs-layouts";
import path from "path";

web.set("view engine", "ejs");
web.set("views", path.join(\_\_dirname, "..", "views"));
web.use(expressLayouts);
web.set("layout", "layouts/main");

Then, go to src/routes/main-route.ts and uncomment this:

mainRouter.get("/", (req, res) => {
res.render("index", { title: "Home Page" });
});

Getting Started

Scaffold a New Project

npx create-craftjs  my-app

OR

npm init craftjs my-app

Go to project folder

cd my-app

Run Craft Setup

npm install
node craft key:generate
node craft generate
node craft db:migrate
node craft dev

Available Craft Commands

node craft help

Project Structure

my-app/
├── craft/
├── src/
│   ├── apidocs/
│   ├── config/
│   ├── controllers/
│   ├── middleware/
│   ├── repositories/
│   ├── dtos/
│   ├── routes/
│   └── services/
│   └── types/
│   └── utils/
│   └── validations/
│   └── main.ts
├── test/
├── logs/
├── docker-compose.yml
├── Dockerfile
├── .env
├── .env.example
├── prisma/
├── .gitignore
├── babel.config.json
├── craft.js
├── nodemon.json
├── package.json
├── package-lock.json
└── tsconfig.json

Scripts

Command	Description
craft start	Start production server
craft dev	Run in development mode
craft build	Build for production
craft test	Run Jest tests
craft db:generate	Generate Prisma client
craft db:migrate	Run Prisma migrations
craft db:reset	Run Prisma migrations refresh
craft key:generate	Generate secret keys
craft make:controller	Make Controller File
craft make:command	Make Command File
craft make:middleware	Make Middleware File
craft make:repository	Make repository File
craft make:dto	Make Data Transfer Object File
craft make:route	Make Route File
craft make:service	Make Service File
craft make:test	Make Test case
craft make:utils	Make Utils
craft make:validation	Make Validation
craft make:view	Make View

Made by @muhammadisa-n