Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
076dce2
refactor(cli): route argv to scaffold, make and skills commands
ru44 Oct 10, 2026
db07b9e
feat(make): generator engine, stack detection, express and react gene…
ru44 Oct 10, 2026
58a3242
feat(skills): cliuno skills status/install, packaged skills and Claud…
ru44 Oct 10, 2026
956352e
test(make): integration script that generates a resource in every tem…
ru44 Oct 10, 2026
c904f57
docs: cliuno-make skill, README, CLAUDE.md, design spec and plan
ru44 Oct 10, 2026
717f3c4
test(make): allow a custom CLI build path in the integration script
ru44 Oct 10, 2026
11a6fd3
style: format scripts with oxfmt
ru44 Oct 10, 2026
457fbc8
test(make): allow Vue and Angular interpolation in the render test
ru44 Oct 10, 2026
d0d195f
feat(make): nest and adonis generators
ru44 Oct 10, 2026
a8892ca
fix(make): terminate ASP.NET string initializers; mirror template CI …
ru44 Oct 10, 2026
4d31299
docs(skills): regenerate the per-stack make:resource reference from t…
ru44 Oct 10, 2026
e8e16fc
build(deps): update dependencies to latest (2026-10)
ru44 Oct 10, 2026
4415d92
style: reformat with oxfmt 0.72
ru44 Oct 10, 2026
b4bf7e4
fix(make): use TypeORM object-form relations in the express, nest and…
ru44 Oct 10, 2026
fb79f42
fix(make): assert the route id in the svelte detail page stub
ru44 Oct 10, 2026
fe9f77d
fix(cli): safer flag parsing, honest error exits and robust native calls
ru44 Oct 10, 2026
a6420dd
fix(skills): never delete edited or unknown skill directories
ru44 Oct 10, 2026
4be8dc5
fix(make): owner checks, safe PATCH, stable imports and usable JSON f…
ru44 Oct 10, 2026
c323fe3
feat(make): nuxt 4 app/ paths and livewire 4 pages for tallstack
ru44 Oct 10, 2026
0644572
test(make): fresh scratch per run, safe --keep and strict --only
ru44 Oct 10, 2026
f1ed566
docs: pin cliuno ^2.2 for the new commands and qualify matrix claims
ru44 Oct 10, 2026
074ace5
feat(cli): add Axum to the scaffolder and fix the Drogon and Spring i…
ru44 Oct 10, 2026
994fc7a
fix(make): use Jackson 3 packages in the spring stub on Spring Boot 4
ru44 Oct 10, 2026
aabe60d
fix(make): declare drogon JSON helpers before the row serializer uses…
ru44 Oct 10, 2026
4fe77ed
fix(make): keep generic types inside backticks in the flutter api doc…
ru44 Oct 10, 2026
d6cdc88
test(matrix): add the axum backend column and scan the nuxt 4 layout
ru44 Oct 10, 2026
20b082a
feat(make): axum generator (model, routes, sqlx migration, integratio…
ru44 Oct 10, 2026
be14b72
docs(skills): add Axum, the Nuxt 4 layout and Livewire 4 to the skills
ru44 Oct 10, 2026
c5be340
test(matrix): run the ASP.NET column in Docker when no host SDK suppo…
ru44 Oct 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions .changeset/make-generators.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
---
"cliuno": minor
---

Add `cliuno make:*` generators and ship the Claude skills with the package:

- `cliuno make:resource <Name> --fields a:string,b:int?` generates a working CRUD vertical slice (entity/model + controller/route + validation + test, or API client + list/detail pages) that follows each template's conventions and the shared `{status, message, data}` contract. Single-file generators (`make:controller`, `make:model`, `make:migration`, …) delegate to the framework's own CLI (`php artisan`, `node ace`, `bin/rails g`, `ng g`) when it exists.
- `cliuno make` lists what the detected stack supports; `--dry-run` previews, `--force` overwrites.
- `cliuno skills status|install` installs the `cliuno-scaffold`, `cliuno-make`, and `cliuno-matrix` skills into `.claude/skills/` (or `~/.claude/skills/` with `--global`).
- The repo is now a Claude Code plugin marketplace: `claude plugin marketplace add CLIuno/core` then `claude plugin install cliuno@cliuno`.
18 changes: 18 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
{
"$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
"name": "cliuno",
"owner": {
"name": "ru44",
"url": "https://github.com/ru44"
},
"description": "CLIuno skills: scaffold full-stack apps from contract-tested templates, generate resources with `cliuno make:*`, and run the frontend×backend compatibility matrix.",
"plugins": [
{
"name": "cliuno",
"source": "./",
"description": "Scaffold apps from CLIuno templates, generate resources with cliuno make:*, and verify the shared REST contract.",
"category": "development",
"tags": ["scaffold", "generator", "fullstack", "templates", "rest-api"]
}
]
}
14 changes: 14 additions & 0 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
{
"name": "cliuno",
"version": "2.1.1",
Comment thread
coderabbitai[bot] marked this conversation as resolved.
Resolved
"description": "Scaffold full-stack apps from CLIuno's contract-tested templates, generate resources with `cliuno make:*`, and run the compatibility matrix.",
"author": {
"name": "ru44",
"url": "https://github.com/ru44"
},
"homepage": "https://cliuno.github.io",
"repository": "https://github.com/CLIuno/core",
"license": "MIT",
"keywords": ["cliuno", "scaffold", "generator", "fullstack", "templates"],
"skills": ["./skills/"]
}
61 changes: 61 additions & 0 deletions .claude/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# CLIuno core (the `cliuno` CLI)

TypeScript CLI that scaffolds full-stack apps by cloning the CLIuno templates and running
each stack's install (npm/pnpm/…, composer, uv, bundler), generates resources inside a
scaffolded project (`cliuno make:*`), and ships the Claude skills (`cliuno skills`).
Published to npm as `cliuno`; the repo is also a Claude Code plugin marketplace.

## Commands

```bash
pnpm dev # run the CLI from source (tsx) — e.g. pnpm dev make:resource Post --dry-run
pnpm build # tsup → dist/app.js (ESM-only; prebuild stamps versions into skills/ + plugin.json)
pnpm test # node:test unit tests (src/**/*.test.ts)
pnpm lint / lintfix # oxlint
pnpm fmt / fmt:check # oxfmt
pnpm test:matrix # frontend×backend compatibility matrix (see below)
node scripts/test-generators.mjs [--only express,react] # generate a resource in every local template + run its gates
pnpm release # build + changeset publish
```

## Layout

- `src/app.ts` — entry: `parseArgv` → `help|version|doctor|make|skills|scaffold`.
- `src/cli/argv.ts` — tiny argv parser (`make:<kind> <Name> --fields … --dry-run --force`).
- `src/commands/scaffold.ts` — the interactive menus (unchanged behaviour); `make.ts`,
`skills.ts` — the new commands.
- `src/generators/` — `names.ts` (casing + plural), `fields.ts` (`a:string,b:int?` DSL),
`detect.ts` (manifest probes → `StackId`), `types.ts` (`Generator`/`Command`/`Patch`),
`engine.ts` (native-vs-stub decision, write/patch with `--force`/`--dry-run`,
idempotent patches, optional post-write formatter), `stacks/<id>.ts` one module per
stack (stubs mirror that template's `todo` resource), `stacks/index.ts` registry.
- `src/utils/questions.ts` + `src/utils/links.ts` — menu choices ↔ template repo URLs.
**These two must stay in sync**: every menu value needs a links entry.
- `src/utils/GitHandler.ts` — clone + per-stack install commands; `src/utils/doctor.ts`.
- `skills/` — the packaged Claude skills (`cliuno-scaffold`, `cliuno-make`, `cliuno-matrix`);
`.claude/skills/*` are symlinks to them so they load while working in this workspace.
`.claude-plugin/{marketplace,plugin}.json` — Claude Code plugin manifests
(`claude plugin validate . --strict` must pass).
- `scripts/test-matrix.mjs` — the compatibility matrix (zero-dep Node ≥18). Full guide:
`skills/cliuno-matrix/SKILL.md`.
- `scripts/test-generators.mjs` — generates a resource in a throw-away git worktree of
every local template and runs that stack's typecheck/lint/tests.

## Adding or changing a generator

1. Read the template's `todo` files (router/controller/entity or api/view) — stubs must
mirror their imports, helpers, envelope and formatting exactly.
2. Edit `src/generators/stacks/<id>.ts`; keep `resource` as the full vertical slice and
make single-file kinds delegate to the framework CLI via `native` when one exists.
3. `pnpm test` (the render test covers every registered stack), then
`node scripts/test-generators.mjs --only <id>`.
4. Update `skills/cliuno-make/references/stacks.md`.

## Conventions

- oxc-only tooling (oxlint + oxfmt, 4-space, double quotes here — this repo's own style).
Generated template code uses the template's style (4-space, `semi: false`, single quotes).
- Conventional commits (commitlint via husky); no co-author trailers.
- husky pre-commit runs lint-staged; if `pnpm` suddenly fails with IGNORED_BUILDS, fix
`pnpm-workspace.yaml` `allowBuilds` — don't bypass hooks.
- The matrix must exit 0 before releasing template-facing changes.
1 change: 1 addition & 0 deletions .claude/skills/cliuno-make
1 change: 1 addition & 0 deletions .claude/skills/cliuno-matrix
1 change: 1 addition & 0 deletions .claude/skills/cliuno-scaffold
18 changes: 16 additions & 2 deletions .github/workflows/main.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ on:
push:
branches:
- "**"
pull_request:

jobs:
build:
Expand All @@ -14,8 +15,21 @@ jobs:
version: 10
- uses: actions/setup-node@v4
with:
node-version: 20.x
node-version: 22.x
cache: "pnpm"

- run: pnpm install
- run: pnpm lint && pnpm build
- run: pnpm lint && pnpm fmt:check
- run: pnpm test
- run: pnpm build

plugin:
name: Claude Code plugin manifest
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 22.x
- run: npm install -g @anthropic-ai/claude-code
- run: claude plugin validate . --strict
1 change: 1 addition & 0 deletions .github/workflows/publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ jobs:
id: changesets
uses: changesets/action@v1
with:
version: pnpm changeset:version
publish: bash scripts/ci-publish.sh
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -105,3 +105,4 @@ dist
.tern-port
matrix-report.json
.claude/skills/cliuno-matrix-workspace/
dist-*/
38 changes: 0 additions & 38 deletions CLAUDE.md

This file was deleted.

51 changes: 50 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,10 +43,59 @@ pnpm add -g cliuno
## Running the app

```bash
# run it
# interactive scaffolder: pick a backend, a frontend / mobile app, a package manager
$ cliuno

# health check for every supported stack
$ cliuno --doctor
```

## Generating code inside a scaffolded project (`cliuno make:*`)

Every template implements the same demo app on one REST contract. `cliuno make:*` clones
that pattern for your own resources, in the template's conventions, so you (or an AI
agent) edit fields and business logic instead of writing boilerplate:

```bash
cd my-api # any CLIuno template, any sub-folder
cliuno make # what this stack can generate
cliuno make:resource Product --fields name:string,price:number,inStock:boolean,notes:text?
cliuno make:controller Invoice --dry-run # preview without writing
cliuno make:model Tag --force # overwrite an existing file
```

- `make:resource` generates the whole vertical slice — entity/model + controller/route +
validation + test on backends, API client + list/detail pages on frontends — and
registers it (router, module, `apis/index`, …). Re-running never duplicates registrations.
- Single-file kinds (`make:controller`, `make:model`, `make:migration`, `make:service`,
`make:validator|request|dto`, `make:test`, `make:api`, `make:store`, `make:page`,
`make:component`) delegate to the framework's own CLI when it has one
(`php artisan`, `node ace`, `bin/rails g`, `ng g`, `shadcn add`), otherwise render a
CLIuno stub.
- Field types: `string text int number boolean date json`, add `?` for nullable.

## Claude Code / AI agents

The repo ships three skills (`cliuno-scaffold`, `cliuno-make`, `cliuno-matrix`) that
teach an agent to scaffold from the templates and to run the generators instead of
hand-writing files. Install them in any of these ways:

```bash
# 1. as a Claude Code plugin
claude plugin marketplace add CLIuno/core
claude plugin install cliuno@cliuno
# (inside a session: /plugin marketplace add CLIuno/core, then /plugin install cliuno@cliuno)

# 2. copied into the current project's .claude/skills/ (works offline, no plugin system needed)
npx cliuno@^2.2 skills install # --global → ~/.claude/skills

# 3. with the skills.sh CLI
npx skills add CLIuno/core
```

`cliuno skills status` tells you whether the skills are installed, outdated, or locally
modified. Every template's `CLAUDE.md` asks the agent to run it first.

### Project status

✅ Production ready and maintained.
Expand Down
Loading
Loading