StackCraft Core

Deterministic CLI for generating production-ready backend systems from versioned templates.

What StackCraft Does

StackCraft helps developers generate backend API projects that are:

• buildable
• testable
• Docker-ready
• environment-configured
• CI-ready
• BrikByteOS-compatible
• validated through deterministic release checks

It is designed for developers who want repeatable project scaffolding without manually wiring the same backend foundation again and again.

Install

npm install -g stackcraft-core

Or run directly:

npx stackcraft-core stackcraft --version

Installed CLI command:

stackcraft --version

Generate a Backend API

stackcraft init --name billing-api --type backend-api

Generate into a specific directory:

stackcraft init --name billing-api --type backend-api --output ./tmp

Generated Project Commands

cd billing-api
npm install
npm run build
npm test

Portable tests only:

npm run test:portable

Docker readiness:

cp .env.example .env
docker compose up -d
docker build .

Validate a Generated Project

stackcraft validate --path ./billing-api

JSON output:

stackcraft validate --path ./billing-api --json

Environment Diagnostics

stackcraft doctor
stackcraft doctor --json

Current Template

StackCraft Core currently ships with:

typescript-backend-api

Generated output includes:

package.json
tsconfig.json
Dockerfile
docker-compose.yml
.dockerignore
.env.example
src/
tests/
.bb/config.json
.bb/policies/default.rego
README.md

BrikByteOS Compatibility

Generated projects include .bb/ configuration so release-quality checks can be run later with BrikByteOS:

bb run --all
bb score
bb gate

Development

npm install
npm run build
npm test
npm run typecheck
npm run lint
npm run format:check
npm run validate

Verification Gates

npm run verify:build
npm run verify:package
npm run verify:release
npm run verify:npm-deploy
npm run verify:generated-deployment
npm run verify:generated-portability
npm run post-release:validate

Skip Docker smoke when Docker/network is unavailable:

STACKCRAFT_SKIP_DOCKER_SMOKE=true npm run verify:generated-deployment

Release Flow

npm version patch --no-git-tag-version
npm run validate
git add .
git commit -m "chore(release): bump version"
git tag vX.Y.Z
git push origin main --tags
npm publish --access public
npm run post-release:validate

Design Principles

• deterministic output
• versioned templates
• safe file generation
• no hidden shell execution
• no dependency on local repo state after publishing
• package-root template resolution
• structured CLI errors
• reproducible release validation

License

Business Source License 1.1.

Change License: Apache License 2.0 Change Date: 2029-01-01

Copyright © BrikByte Studios.