biucingcli 0.9.1__py3-none-any.whl

biucingcli/template_data/frontend/template/vite.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    environment: "jsdom",
+    globals: true,
+    setupFiles: "./src/test/setup.ts",
+    include: ["src/**/*.test.{ts,tsx}"],
+  },
+});

biucingcli/template_data/frontend/template.json

@@ -0,0 +1,81 @@
+{
+  "name": "frontend",
+  "description": "React + TypeScript starter for independent projects",
+  "category": "frontend",
+  "stack": ["React", "TypeScript"],
+  "tags": ["web", "docker", "playwright", "vitest"],
+  "platforms": ["web"],
+  "maturity": {
+    "level": "validated",
+    "summary": "Docker-first frontend starter with test and browser-smoke workflows."
+  },
+  "validation": {
+    "status": "real-build-verified",
+    "verification_tier": "real-build",
+    "evidence": [
+      "python unittest template rendering coverage",
+      "real docker runtime image builds",
+      "real docker development image builds",
+      "real Playwright browser checks against the production Nginx image"
+    ]
+  },
+  "operating_assumptions": [
+    "Local development is expected to run through Docker-first workflows.",
+    "Browser smoke coverage and runtime packaging are part of the starter contract."
+  ],
+  "workflow_labels": ["bootstrap", "dev", "test", "build", "runtime"],
+  "commands": {
+    "bootstrap": "make bootstrap",
+    "doctor": "make doctor",
+    "lint": "make lint",
+    "test": "make test",
+    "verify": "make verify",
+    "build": "make build",
+    "clean": "make clean",
+    "help": "make help"
+  },
+  "worktree": {
+    "support_level": "worktree-ready",
+    "isolation_dimensions": [
+      "runtime-names",
+      "ports",
+      "caches",
+      "generated-output",
+      "cleanup",
+      "diagnostics"
+    ],
+    "diagnostics": [
+      "make worktree-info",
+      "make worktree-doctor"
+    ],
+    "cleanup": [
+      "make clean-worktree"
+    ]
+  },
+  "variables": [
+    {
+      "name": "project_name",
+      "required": true,
+      "validator": "project-name"
+    },
+    {
+      "name": "display_name",
+      "required": false,
+      "default_from": "project_name",
+      "validator": "display-name"
+    },
+    {
+      "name": "package_name",
+      "required": false,
+      "default_from": "project_name",
+      "validator": "npm-package"
+    }
+  ],
+  "next_steps": [
+    "make bootstrap",
+    "make dev",
+    "make test",
+    "make docker-build",
+    "make docker-run"
+  ]
+}

biucingcli/template_data/harmonyos/template/.gitignore

@@ -0,0 +1,21 @@
+.hvigor/
+.ohpm/
+build/
+entry/build/
+node_modules/
+oh_modules/
+local.properties
+*.hap
+*.app
+*.log
+
+# Local credentials, signing material, and release backups
+.env
+.env.*
+!.env.example
+/credentials/
+/signing/
+/.biucing/
+*.p8
+*.p12
+*.pfx

biucingcli/template_data/harmonyos/template/.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+node = "22"

biucingcli/template_data/harmonyos/template/AppScope/app.json5

@@ -0,0 +1,10 @@
+{
+  "app": {
+    "bundleName": "{{BUNDLE_NAME}}",
+    "vendor": "{{ORGANIZATION_NAME}}",
+    "versionCode": {{HARMONY_VERSION_CODE}},
+    "versionName": "{{HARMONY_VERSION_NAME}}",
+    "icon": "$media:layered_image",
+    "label": "$string:app_name"
+  }
+}

biucingcli/template_data/harmonyos/template/AppScope/resources/base/element/string.json

@@ -0,0 +1,8 @@
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "{{DISPLAY_NAME}}"
+    }
+  ]
+}

biucingcli/template_data/harmonyos/template/AppScope/resources/base/media/background.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128">
+  <rect width="128" height="128" rx="28" fill="#1F6FEB"/>
+</svg>

biucingcli/template_data/harmonyos/template/AppScope/resources/base/media/foreground.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="128" height="128" viewBox="0 0 128 128">
+  <path d="M33 78c14-31 48-31 62 0" fill="none" stroke="#FFFFFF" stroke-width="10" stroke-linecap="round"/>
+  <circle cx="64" cy="50" r="12" fill="#FFFFFF"/>
+</svg>

biucingcli/template_data/harmonyos/template/AppScope/resources/base/media/layered_image.json

@@ -0,0 +1,6 @@
+{
+  "layered-image": {
+    "background": "$media:background",
+    "foreground": "$media:foreground"
+  }
+}

biucingcli/template_data/harmonyos/template/Makefile

@@ -0,0 +1,106 @@
+SHELL := /bin/zsh
+HVIGOR ?= hvigorw
+
+APP_NAME={{PROJECT_NAME}}
+WORKTREE_ROOT ?= $(shell git rev-parse --show-toplevel 2>/dev/null || pwd)
+WORKTREE_LABEL ?= $(shell basename "$(WORKTREE_ROOT)" | tr '[:upper:]' '[:lower:]' | tr -cs 'a-z0-9' '-' | sed 's/^-//; s/-$$//')
+WORKTREE_ID ?= $(shell printf '%s' "$(WORKTREE_ROOT)" | shasum | cut -c1-8)
+WORKTREE_SLUG ?= $(APP_NAME)-$(WORKTREE_ID)
+HVIGOR_HOME ?= $(WORKTREE_ROOT)/.hvigor/worktree/$(WORKTREE_ID)
+OHPM_HOME ?= $(WORKTREE_ROOT)/.ohpm/worktree/$(WORKTREE_ID)
+OH_MODULES_DIR ?= $(WORKTREE_ROOT)/oh_modules
+MODULE_BUILD_DIR ?= $(WORKTREE_ROOT)/{{HARMONY_MODULE_NAME}}/build
+LOCAL_PROPERTIES ?= $(WORKTREE_ROOT)/local.properties
+DEBUG_BUNDLE_SUFFIX ?= .$(WORKTREE_ID)
+EFFECTIVE_DEBUG_BUNDLE_NAME ?= {{BUNDLE_NAME}}$(DEBUG_BUNDLE_SUFFIX)
+HVIGOR_PROPS := -p module={{HARMONY_MODULE_NAME}} -p biucing.worktree.id=$(WORKTREE_ID) -p biucing.worktree.bundleSuffix=$(DEBUG_BUNDLE_SUFFIX)
+
+export HVIGOR_HOME
+export OHPM_HOME
+export BIUCING_HARMONY_DEBUG_BUNDLE_SUFFIX := $(DEBUG_BUNDLE_SUFFIX)
+
+.PHONY: bootstrap doctor verify-supply-chain lint test build package artifact-info verify verify-release-artifact release-preflight release signing-info clean open worktree-info worktree-doctor worktree-debug-identity clean-worktree help
+
+bootstrap:
+	./scripts/bootstrap
+
+doctor:
+	./scripts/doctor
+
+verify-supply-chain:
+	./scripts/verify-supply-chain
+
+lint test build release-preflight release: verify-supply-chain
+
+lint:
+	./scripts/lint
+
+test:
+	./scripts/test
+
+build:
+	$(HVIGOR) assembleHap --mode module $(HVIGOR_PROPS)
+
+package: build
+
+artifact-info:
+	./scripts/artifact-info
+
+verify-release-artifact:
+	./scripts/verify-release-artifact
+
+verify: verify-supply-chain doctor lint test build artifact-info
+
+release-preflight:
+	./scripts/release-preflight
+
+release:
+	./scripts/release-build
+
+signing-info:
+	@printf '%s\n' "Configure signing in DevEco Studio or copy docs/release-signing.local.properties.example to local.properties, then run make release-preflight and make release."
+
+clean:
+	$(HVIGOR) clean
+
+open:
+	open -a "DevEco Studio" .
+
+worktree-info:
+	@printf '%s\n' "Project: {{PROJECT_NAME}}"
+	@printf '%s\n' "Worktree root: $(WORKTREE_ROOT)"
+	@printf '%s\n' "WORKTREE_LABEL: $(WORKTREE_LABEL)"
+	@printf '%s\n' "WORKTREE_ID: $(WORKTREE_ID)"
+	@printf '%s\n' "WORKTREE_SLUG: $(WORKTREE_SLUG)"
+	@printf '%s\n' "HVIGOR_HOME: $(HVIGOR_HOME)"
+	@printf '%s\n' "OHPM_HOME: $(OHPM_HOME)"
+	@printf '%s\n' "oh_modules: $(OH_MODULES_DIR)"
+	@printf '%s\n' "Module build dir: $(MODULE_BUILD_DIR)"
+	@printf '%s\n' "local.properties: $(LOCAL_PROPERTIES)"
+	@printf '%s\n' "Debug bundle suffix: $(DEBUG_BUNDLE_SUFFIX)"
+	@printf '%s\n' "Diagnostic debug bundle name: $(EFFECTIVE_DEBUG_BUNDLE_NAME)"
+	@printf '%s\n' "Debug bundle rewriting: deferred; AppScope/app.json5 stays stable by default."
+
+worktree-doctor:
+	@printf '%s\n' "Checking HarmonyOS worktree isolation..."
+	@test -n "$(WORKTREE_ID)" || (printf '%s\n' "WORKTREE_ID is empty" && exit 1)
+	@case "$(HVIGOR_HOME)" in "$(WORKTREE_ROOT)"/*) ;; *) printf '%s\n' "HVIGOR_HOME should stay inside this worktree: $(HVIGOR_HOME)"; exit 1;; esac
+	@case "$(OHPM_HOME)" in "$(WORKTREE_ROOT)"/*) ;; *) printf '%s\n' "OHPM_HOME should stay inside this worktree: $(OHPM_HOME)"; exit 1;; esac
+	@if [ -f "$(LOCAL_PROPERTIES)" ]; then printf '%s\n' "local.properties is local to this worktree and must remain untracked."; else printf '%s\n' "local.properties is absent; make release requires local signing material."; fi
+	@printf '%s\n' "Debug identity check: make worktree-debug-identity"
+	@printf '%s\n' "HarmonyOS worktree isolation looks ready."
+
+worktree-debug-identity:
+	@printf '%s\n' "HarmonyOS debug identity status"
+	@printf '%s\n' "Base bundle name: {{BUNDLE_NAME}}"
+	@printf '%s\n' "Debug bundle suffix: $(DEBUG_BUNDLE_SUFFIX)"
+	@printf '%s\n' "Diagnostic debug bundle name: $(EFFECTIVE_DEBUG_BUNDLE_NAME)"
+	@printf '%s\n' "Hvigor properties: biucing.worktree.id=$(WORKTREE_ID), biucing.worktree.bundleSuffix=$(DEBUG_BUNDLE_SUFFIX)"
+	@printf '%s\n' "Status: bundle rewriting is deferred until the DevEco/hvigor app metadata hook is verified."
+	@printf '%s\n' "AppScope/app.json5 remains the source of truth for bundleName."
+
+clean-worktree:
+	rm -rf "$(HVIGOR_HOME)" "$(OHPM_HOME)" "$(MODULE_BUILD_DIR)" build .biucing/release
+
+help:
+	@printf '%s\n' "Common commands:" "  make bootstrap  Prepare project dependencies and tooling" "  make doctor     Check the local environment" "  make lint       Run static checks" "  make test       Run automated tests" "  make verify     Run the template quality gate" "  make build      Build the project" "  make clean      Remove generated build state" "  make help       Show this command contract"

biucingcli/template_data/harmonyos/template/README.md

@@ -0,0 +1,152 @@
+# {{DISPLAY_NAME}}
+
+This project was generated by BiucingCLI as an ArkTS HarmonyOS starter.
+
+## Stack
+
+- ArkTS
+- ArkUI declarative UI
+- HarmonyOS Stage model
+- DevEco Studio
+- hvigor or hvigorw
+- ohpm
+
+## Configuration
+
+- Bundle name: `{{BUNDLE_NAME}}`
+- Entry module: `{{HARMONY_MODULE_NAME}}`
+- Entry ability: `{{ABILITY_NAME}}`
+- Compatible SDK: `{{COMPATIBLE_SDK_VERSION}}`
+- Target SDK: `{{TARGET_SDK_VERSION}}`
+- Minimum API: `{{MIN_API_VERSION}}`
+- Version: `{{HARMONY_VERSION_NAME}}` (`{{HARMONY_VERSION_CODE}}`)
+
+## Repository Layout
+
+- `AppScope/app.json5`: application-level HarmonyOS metadata
+- `entry/`: installable HarmonyOS entry module
+- `entry/src/main/module.json5`: module, ability, device, and page routing metadata
+- `entry/src/main/ets/core/config/`: generated app configuration constants
+- `entry/src/main/ets/core/designsystem/`: shared ArkUI tokens for color, spacing, radius, and type
+- `entry/src/main/ets/entryability/`: Stage model ability lifecycle
+- `entry/src/main/ets/pages/`: ArkUI `Index` and `Settings` pages
+- `scripts/`: bootstrap and local environment checks
+- `docs/`: release signing notes and local-only signing property examples
+
+## Getting Started
+
+```bash
+make bootstrap
+make doctor
+make verify-supply-chain
+make lint
+make test
+make build
+make artifact-info
+make verify
+make release-preflight
+make verify-release-artifact
+make release
+```
+
+`make doctor` checks Node.js, ohpm, hvigor or hvigorw, `DEVECO_SDK_HOME`, and common HarmonyOS SDK environment variables before you spend time on a build.
+For a default macOS DevEco Studio install, the CLI build environment usually looks like:
+
+```bash
+export PATH="/Applications/DevEco-Studio.app/Contents/tools/ohpm/bin:/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin:$PATH"
+export DEVECO_SDK_HOME="/Applications/DevEco-Studio.app/Contents/sdk"
+export HOS_SDK_HOME="/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony"
+```
+Open the project with DevEco Studio when you need signing, device management, previewer, or emulator workflows.
+`make bootstrap` first verifies exact ohpm versions, the approved registry, and every lockfile SHA-512 integrity value; it fails if installation rewrites the lockfile. `make test` runs the starter Hypium suite through `hvigorw test`. `make build` creates an unsigned HAP by default. `make artifact-info` verifies the latest HAP exists, is non-empty, and prints its checksum. `make verify` includes the supply-chain gate before `doctor`, `lint`, `test`, `build`, and `artifact-info`. `make release-preflight` checks local signing material and rejects signing values left in the tracked build profile. `make release` requires a clean tracked `build-profile.json5`, temporarily injects release signing config, runs hvigor with `buildMode=release`, verifies the signed HAP, and restores the exact original profile on exit.
+
+## Worktree Workflow
+
+Each worktree derives a human-readable `WORKTREE_LABEL` from its directory name
+and a hash-based `WORKTREE_ID` from the worktree root path. Override
+`WORKTREE_ID` when you want a shorter or stable value across renamed folders:
+
+```bash
+WORKTREE_ID=feature-a make worktree-info
+WORKTREE_ID=feature-a make worktree-debug-identity
+WORKTREE_ID=feature-a make build
+WORKTREE_ID=feature-a make clean-worktree
+```
+
+`make worktree-info` prints the isolated hvigor, ohpm, `oh_modules`, module
+build, and signing-file paths. `make worktree-doctor` checks that tool caches
+stay inside this worktree and reminds you that `local.properties` is local-only
+signing material.
+
+`make worktree-debug-identity` prints the base bundle name, requested
+`DEBUG_BUNDLE_SUFFIX`, diagnostic debug bundle name, and hvigor properties. It
+is intentionally read-only: `AppScope/app.json5` remains the source of truth for
+`bundleName`. Automatic per-worktree bundle rewriting is deferred until the
+DevEco/hvigor app metadata hook is verified on a configured HarmonyOS
+workstation.
+
+## Standard Commands
+
+```bash
+make bootstrap
+make doctor
+make verify-supply-chain
+make lint
+make test
+make build
+make package
+make artifact-info
+make verify
+make release-preflight
+make verify-release-artifact
+make release
+make signing-info
+make clean
+make open
+make help
+```
+
+## Testing
+
+The generated starter exposes `make test` through `hvigorw test --mode module -p module={{HARMONY_MODULE_NAME}}`. The template includes `@ohos/hypium` as a dev dependency and a starter smoke suite at `entry/src/test/List.test.ets`. Run `make bootstrap` before `make test` so ohpm can install test dependencies.
+
+`make verify` treats tests as a required release-readiness gate. If the local ohpm registry, SDK, or Hypium dependency is unavailable, the test command fails with a clear setup message instead of silently skipping tests.
+
+## Linting
+
+`make lint` is a project guard, not a full ArkTS linter. It validates `code-linter.json5`, required HarmonyOS source/config files, and unrendered template placeholders. DevEco Studio remains the full lint surface until a stable public CLI lint or format command is verified for generated HAP projects.
+
+## Release Signing
+
+Local builds produce an unsigned HAP unless signing is configured. Use DevEco Studio for interactive signing setup, or copy `docs/release-signing.local.properties.example` to `local.properties` for local-only signing values. Put `.cer`, `.p7b`, and `.p12` signing material under the ignored `signing/` directory. `make release-preflight` fails fast when required values are missing, paths do not resolve, or signing material remains in tracked `build-profile.json5`.
+
+`make release` stores a mode-restricted backup under the ignored `.biucing/release/` directory, writes the injected profile atomically, and restores the original bytes after success, build failure, `HUP`, `INT`, or `TERM`. Before reporting success it uses the SDK's `hap-sign-tool verify-app` and `verify-profile` commands, compares the embedded signer certificate and profile with the configured inputs, and verifies the profile's bundle name is exactly `{{BUNDLE_NAME}}`. Any mismatch fails the release. `SIGKILL` cannot run cleanup handlers; the next preflight detects a non-empty signing configuration. Do not stage Git changes concurrently with a signed release build.
+
+Set `HAP_SIGN_TOOL` only when the SDK tool cannot be found under `DEVECO_SDK_HOME` or the default DevEco Studio installation. CI should point it at the reviewed SDK's `hap-sign-tool.jar`, not an arbitrary replacement.
+
+The ignore rules also protect `credentials/`, private-key containers, and local environment files. They only apply to untracked files and do not override `git add -f`. If a real credential has already been committed, revoke or rotate it first, remove it from the index, and assess whether repository history must be rewritten.
+
+## Pre-Distribution Coverage
+
+The template intentionally stops before app-market upload or enterprise distribution. Before that handoff, the supported local stages are:
+
+- `make bootstrap`: verify the lockfile, install HarmonyOS dependencies, and reject lockfile drift.
+- `make verify-supply-chain`: enforce exact package versions, approved ohpm registry URLs, and SHA-512 integrity values.
+- `make doctor`: verify DevEco Studio, Node.js, ohpm, hvigor, and SDK paths.
+- `make lint`: validate committed lint/config shape and generated template integrity.
+- `make test`: run ArkTS/Hypium CLI tests.
+- `make build`: produce an unsigned HAP.
+- `make artifact-info`: verify and fingerprint the package artifact.
+- `make release-preflight`: verify signing material is present.
+- `make verify-release-artifact`: cryptographically verify a signed HAP, signer, profile, and bundle identity.
+- `make release`: produce and verify a release HAP when signing material is configured.
+
+## Notes
+
+- `oh-package.json5` is the project dependency manifest; dependencies must use exact versions and stay aligned with `oh-package-lock.json5`.
+- `build-profile.json5` declares the app signing placeholder and entry module.
+- `code-linter.json5` is committed so DevEco Studio and later CLI lint wiring share one rule source.
+- `docs/release-signing.local.properties.example` documents placeholder-only local signing keys; `local.properties`, `signing/`, `credentials/`, and `.biucing/` are git-ignored.
+- The generated starter keeps app metadata in `AppConfig` and visual constants in `core/designsystem` so feature pages do not duplicate bundle, version, spacing, or color values.
+- Signing is left to DevEco Studio or CI-specific `local.properties` configuration.
+- Keep `bundleName`, module name, and SDK versions aligned with your target HarmonyOS release channel before store packaging.

biucingcli/template_data/harmonyos/template/build-profile.json5

@@ -0,0 +1,36 @@
+{
+  "app": {
+    "signingConfigs": [],
+    "products": [
+      {
+        "name": "default",
+        "signingConfig": "default",
+        "compatibleSdkVersion": "{{COMPATIBLE_SDK_VERSION}}",
+        "targetSdkVersion": "{{TARGET_SDK_VERSION}}",
+        "runtimeOS": "HarmonyOS"
+      }
+    ],
+    "buildModeSet": [
+      {
+        "name": "debug"
+      },
+      {
+        "name": "release"
+      }
+    ]
+  },
+  "modules": [
+    {
+      "name": "{{HARMONY_MODULE_NAME}}",
+      "srcPath": "./entry",
+      "targets": [
+        {
+          "name": "default",
+          "applyToProducts": [
+            "default"
+          ]
+        }
+      ]
+    }
+  ]
+}

biucingcli/template_data/harmonyos/template/code-linter.json5

@@ -0,0 +1,12 @@
+{
+  "files": [
+    "**/*.ets",
+    "**/*.ts"
+  ],
+  "ignore": [
+    "oh_modules/**",
+    "build/**",
+    ".hvigor/**"
+  ],
+  "rules": {}
+}

biucingcli/template_data/harmonyos/template/docs/release-signing.local.properties.example

@@ -0,0 +1,14 @@
+# This example must contain placeholders only. Never put real credentials here.
+# Copy these keys into local.properties for local-only HarmonyOS signing setup.
+# Do not commit real signing material.
+#
+# DevEco Studio can manage signing interactively. Use this file only when the
+# team has agreed on CLI/CI signing property names.
+
+biucing.harmony.signing.certpath=signing/release.cer
+biucing.harmony.signing.profile=signing/release.p7b
+biucing.harmony.signing.storeFile=signing/release.p12
+biucing.harmony.signing.storePassword=change-me-32-characters-minimum
+biucing.harmony.signing.keyAlias=release
+biucing.harmony.signing.keyPassword=change-me-32-characters-minimum
+biucing.harmony.signing.signAlg=SHA256withECDSA

biucingcli/template_data/harmonyos/template/entry/build-profile.json5

@@ -0,0 +1,9 @@
+{
+  "apiType": "stageMode",
+  "buildOption": {},
+  "targets": [
+    {
+      "name": "default"
+    }
+  ]
+}

biucingcli/template_data/harmonyos/template/entry/hvigorfile.ts

@@ -0,0 +1,6 @@
+import { hapTasks } from '@ohos/hvigor-ohos-plugin';
+
+export default {
+  system: hapTasks,
+  plugins: []
+}

biucingcli/template_data/harmonyos/template/entry/oh-package.json5

@@ -0,0 +1,9 @@
+{
+  "name": "{{HARMONY_MODULE_NAME}}",
+  "version": "{{HARMONY_VERSION_NAME}}",
+  "description": "{{DISPLAY_NAME}} entry module",
+  "main": "",
+  "author": "{{ORGANIZATION_NAME}}",
+  "license": "MIT",
+  "dependencies": {}
+}

biucingcli/template_data/harmonyos/template/entry/src/main/ets/core/config/AppConfig.ets

@@ -0,0 +1,10 @@
+export class AppConfig {
+  static readonly displayName: string = '{{DISPLAY_NAME}}';
+  static readonly bundleName: string = '{{BUNDLE_NAME}}';
+  static readonly worktreeBundleSuffix: string = '';
+  static readonly moduleName: string = '{{HARMONY_MODULE_NAME}}';
+  static readonly abilityName: string = '{{ABILITY_NAME}}';
+  static readonly versionName: string = '{{HARMONY_VERSION_NAME}}';
+  static readonly versionCode: string = '{{HARMONY_VERSION_CODE}}';
+  static readonly releaseChannel: string = 'local';
+}

biucingcli/template_data/harmonyos/template/entry/src/main/ets/core/designsystem/Tokens.ets

@@ -0,0 +1,28 @@
+export class BiucingColors {
+  static readonly accent: string = '#246BFD';
+  static readonly accentSoft: string = '#E8F0FF';
+  static readonly success: string = '#137333';
+  static readonly successSoft: string = '#E7F4EC';
+}
+
+export class BiucingSpacing {
+  static readonly xSmall: number = 4;
+  static readonly small: number = 8;
+  static readonly medium: number = 12;
+  static readonly large: number = 16;
+  static readonly xLarge: number = 24;
+  static readonly xxLarge: number = 32;
+}
+
+export class BiucingRadius {
+  static readonly small: number = 8;
+  static readonly medium: number = 12;
+  static readonly large: number = 16;
+}
+
+export class BiucingTypography {
+  static readonly title: number = 30;
+  static readonly sectionTitle: number = 20;
+  static readonly body: number = 16;
+  static readonly caption: number = 14;
+}

biucingcli/template_data/harmonyos/template/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,29 @@
+import AbilityConstant from '@ohos.app.ability.AbilityConstant';
+import UIAbility from '@ohos.app.ability.UIAbility';
+import Want from '@ohos.app.ability.Want';
+import hilog from '@ohos.hilog';
+import window from '@ohos.window';
+
+const DOMAIN = 0x0000;
+const TAG = '{{ABILITY_NAME}}';
+
+export default class {{ABILITY_NAME}} extends UIAbility {
+  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
+    hilog.info(DOMAIN, TAG, 'Ability created for {{DISPLAY_NAME}}.');
+  }
+
+  onWindowStageCreate(windowStage: window.WindowStage): void {
+    windowStage.loadContent('pages/Index', (error) => {
+      if (error.code) {
+        hilog.error(DOMAIN, TAG, 'Failed to load content. code=%{public}d message=%{public}s', error.code, error.message);
+        return;
+      }
+
+      hilog.info(DOMAIN, TAG, 'Loaded {{DISPLAY_NAME}} content.');
+    });
+  }
+
+  onDestroy(): void {
+    hilog.info(DOMAIN, TAG, 'Ability destroyed.');
+  }
+}

biucingcli/template_data/harmonyos/template/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,47 @@
+import { AppConfig } from '../core/config/AppConfig';
+import { BiucingColors, BiucingRadius, BiucingSpacing, BiucingTypography } from '../core/designsystem/Tokens';
+
+@Entry
+@Component
+struct Index {
+  build() {
+    Column({ space: BiucingSpacing.large }) {
+      Text(AppConfig.displayName)
+        .fontSize(BiucingTypography.title)
+        .fontWeight(FontWeight.Bold)
+        .fontColor($r('app.color.text_primary'))
+
+      Text('Generated by BiucingCLI')
+        .fontSize(BiucingTypography.body)
+        .fontColor($r('app.color.text_secondary'))
+
+      Column({ space: BiucingSpacing.small }) {
+        Text(`Bundle: ${AppConfig.bundleName}`)
+          .fontSize(BiucingTypography.caption)
+        Text(`Module: ${AppConfig.moduleName}`)
+          .fontSize(BiucingTypography.caption)
+        Text(`Channel: ${AppConfig.releaseChannel}`)
+          .fontSize(BiucingTypography.caption)
+          .fontColor(BiucingColors.success)
+      }
+      .alignItems(HorizontalAlign.Start)
+      .padding(BiucingSpacing.large)
+      .borderRadius(BiucingRadius.medium)
+      .backgroundColor($r('app.color.surface'))
+      .width('100%')
+
+      Button('Open settings')
+        .fontSize(BiucingTypography.body)
+        .backgroundColor(BiucingColors.accent)
+        .onClick(() => {
+          this.getUIContext().getRouter().pushUrl({ url: 'pages/Settings' });
+        })
+    }
+    .justifyContent(FlexAlign.Center)
+    .alignItems(HorizontalAlign.Center)
+    .height('100%')
+    .width('100%')
+    .padding(BiucingSpacing.xLarge)
+    .backgroundColor($r('app.color.page_background'))
+  }
+}