big-bst

Full-stack scaffolder: one CLI run produces a React + Express + MySQL workspace with CRUD, auth, reports, and FK-aware UI.

Install & run

npm install -g big-bst
big-bst

Or from this repo:

npm install
node index.js
# or: npx .

What you get

• Backend — Express + MySQL2, CRUD per entity, JWT or session auth, role permissions, reports/bill routes, dropdown validation
• Frontend — React + Vite + Tailwind, FK <select> options labeled by each entity’s display column (not raw IDs), fixed-option dropdowns from the CLI, daily reports and receipts
• Database — database.sql, FK constraints, optional report view, report.config.json

CLI highlights

• Column-by-column builder: Text, Number, Money, Date, DateTime, Boolean, Email, Phone, FK
• Per-entity display column (e.g. plateNumber, studentName) used in FK dropdowns, tables, and reports
• Fixed dropdown options on non-FK columns (rendered as <select> in forms)
• Stock auto-detection, duplicate entity names blocked, port collision prompts

Offline installs (optional)

After a one-time cache warm-up, generated projects can install without hitting the registry:

npm run vendor:refresh

Then run big-bst as usual. runInstall uses .npm-cache when present; otherwise it runs a normal npm install.

Development

npm run check:syntax   # syntax-check generators + CLI
npm test               # smoke + dry-run generation tests
npm audit              # dependency audit
npm pack --dry-run     # preview publish tarball

Requirements

• Node.js 18+
• MySQL for the generated app (not required to run the CLI itself)

License

MIT