BiucingCLI

BiucingCLI is a scaffold generator for independent developers who want practical, reusable project starters built around a stable personal stack.

The project is being restarted from a clean slate with a narrower goal: generate useful project skeletons, not an all-purpose agent workflow.

Version

The current repository release target is 0.7.0.

biucing --version

See CHANGELOG.md for the latest release summary.

Product Direction

BiucingCLI focuses on a small set of templates that match the maintainer's real development habits:

• frontend: React + TypeScript starter with Docker-first local development, Vitest, and Playwright smoke checks
• web-service: Go + Gin web service starter with Docker development/runtime workflows
• microservice: Go + Protobuf + Buf + Compose starter with gRPC, OpenTelemetry, and local dependency orchestration
• worker: Go background worker starter with scheduled and oneshot execution modes
• apple: SwiftUI + Tuist + SwiftPM Apple app starter for ios, macos, watchos, and tvos
• android: Kotlin + Gradle + Jetpack Compose Android app starter with fastlane and a committed Gradle wrapper
• harmonyos: ArkTS + ArkUI HarmonyOS app starter for DevEco Studio projects

The value is not broad ecosystem coverage. The value is generating starters that are restrained, readable, and worth using as a real base.

Intended Users

• Independent developers who frequently start new projects.
• Builders who prefer a consistent personal stack over endless framework choices.
• Developers who want fewer setup decisions at project start.

First Commands

biucing list
biucing info frontend
biucing info web-service
biucing info microservice
biucing info worker
biucing info apple
biucing info android
biucing info harmonyos
biucing create frontend my-app --dry-run
biucing create web-service user-service --plan --json
biucing create frontend my-app
biucing create web-service user-service
biucing create microservice user-service
biucing create worker email-worker
biucing create apple my-apple-app
biucing create android my-android-app
biucing create harmonyos my-harmony-app

Project Status

This repository contains a small internal template system with practical starters for seven flows:

• frontend
• web-service
• microservice
• worker
• apple
• android
• harmonyos

The current maturity split is:

• frontend, web-service, and microservice are fully Dockerized for development, verification, and runtime packaging.
• worker is a backend-adjacent starter for scheduled and oneshot background execution, with generated-project go test ./... validation and Docker packaging.
• apple and android are now first-class native platform starters with stronger doctor flows, release guidance, richer starter architecture, and repeated real generated-project validation.
• harmonyos is an experimental native starter for ArkTS/ArkUI projects that open in DevEco Studio and expose bootstrap, doctor, lint, build, and signing guidance workflows.

Generator UX status:

• biucing create ... --dry-run previews resolved variables, target location, template file count, and next steps without writing files;
• biucing create ... --plan --json returns a machine-readable preview payload for scripts and automation;
• biucing create ... --json returns a machine-readable manifest after a real generation run;
• non-interactive create failures now report all missing required values together.

Template consistency status:

• template metadata now exposes verification tier, operating assumptions, and workflow labels;
• biucing validate now checks the stronger metadata contract plus family-level required starter entries;
• biucing info <template> now surfaces those consistency fields directly.

Worktree-first status:

• all seven templates now declare worktree-ready support metadata;
• generated projects expose make worktree-info, make worktree-doctor, and make clean-worktree;
• Docker-first starters isolate Compose project names, volumes, image tags, published host ports, dependency stores, and caches;
• Docker-first starters now expose port conflict advice and make worktree-compose-config for non-invasive Compose diagnostics;
• native starters isolate build caches, local signing/config files, generated output, and debug install identity hooks where the platform supports them;
• native release evidence is now labeled as static, doctor, or real-build so worktree claims do not overstate SDK-backed coverage.

Local Android validation status:

• the Android starter now includes a committed Gradle wrapper;
• the generated Android project has passed real lint, JVM unit tests, debug APK and release AAB builds, plus AAB integrity checks;
• the maintainer workstation has validated the Compose UI smoke test on Biucing_API_35.

Local Apple validation status:

• the generated Apple starter has passed real make generate verification for both iOS and macOS;
• iOS output now renders a mobile-specific starter structure and has passed real make build;
• macOS output now renders a desktop-specific starter structure and has passed real make test.

Local HarmonyOS validation status:

• the generated HarmonyOS starter has passed real make bootstrap and make verify verification with a local DevEco Studio/HarmonyOS SDK install;
• make verify now covers doctor, lint, ArkTS/Hypium test, unsigned HAP build, and package artifact fingerprinting;
• make release-preflight and make release are wired to local-only signing material and fail fast when local.properties is missing or incomplete.

Design Docs

• Android template note: the current Android starter now includes a committed gradle-wrapper.jar; if the team refreshes Gradle later, commit the regenerated wrapper files back into the repo.
• 0.3.0 Plan
• 0.4.0 Plan
• 0.6.0 Plan
• 0.6.0 Worktree Task Breakdown
• Worktree Isolation Contract
• 0.6.0 Worktree Collision Audit
• 0.6.0 Release Prep
• 0.6.1 Plan
• 0.6.1 Worktree Hardening Task Breakdown
• 0.6.1 Release Prep
• 0.7.0 Release Notes
• 0.7.0 Release Prep
• 0.4.0 Release Prep
• 0.3.0 Release Prep
• Release Checklist
• Verification Matrix
• Product Design
• Roadmap
• Template System
• Web Service Team Environment Standard
• Microservice Team Environment Standard
• Apple Team Environment Standard
• Android Team Environment Standard
• HarmonyOS Team Environment Standard
• Android Template Design
• Microservice Template Design