@bleedingdev/modern-js-create 3.2.0-ultramodern.0

package/dist/types/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/locale/en.d.ts

@@ -0,0 +1,55 @@
+export declare const EN_LOCALE: {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+};

package/dist/types/locale/index.d.ts

@@ -0,0 +1,112 @@
+import { I18n } from '@modern-js/i18n-utils';
+declare const i18n: I18n;
+declare const localeKeys: {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+} | {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+};
+export { i18n, localeKeys };

package/dist/types/locale/zh.d.ts

@@ -0,0 +1,55 @@
+export declare const ZH_LOCALE: {
+    prompt: {
+        projectName: string;
+    };
+    error: {
+        projectNameEmpty: string;
+        directoryExists: string;
+        invalidRouter: string;
+        invalidBffRuntime: string;
+        createFailed: string;
+    };
+    message: {
+        welcome: string;
+        success: string;
+        nextSteps: string;
+        step1: string;
+        step2: string;
+        step3: string;
+    };
+    help: {
+        title: string;
+        description: string;
+        usage: string;
+        usageExample: string;
+        options: string;
+        optionHelp: string;
+        optionVersion: string;
+        optionLang: string;
+        optionRouter: string;
+        optionBff: string;
+        optionBffRuntime: string;
+        optionTailwind: string;
+        optionWorkspace: string;
+        optionUltramodernWorkspace: string;
+        optionUltramodernPackageSource: string;
+        optionUltramodernPackageScope: string;
+        optionUltramodernPackageNamePrefix: string;
+        optionSub: string;
+        examples: string;
+        example1: string;
+        example2: string;
+        example3: string;
+        example4: string;
+        example5: string;
+        example6: string;
+        example7: string;
+        example8: string;
+        example9: string;
+        example10: string;
+        moreInfo: string;
+    };
+    version: {
+        message: string;
+    };
+};

package/dist/types/ultramodern-workspace.d.ts

@@ -0,0 +1,20 @@
+type UltramodernPackageSourceStrategy = 'workspace' | 'install';
+export type UltramodernWorkspaceOptions = {
+    targetDir: string;
+    packageName: string;
+    modernVersion: string;
+    packageSource?: {
+        strategy?: UltramodernPackageSourceStrategy;
+        modernPackageVersion?: string;
+        registry?: string;
+        aliasScope?: string;
+        aliasPackageNamePrefix?: string;
+    };
+};
+export declare const ULTRAMODERN_WORKSPACE_FLAG = "--ultramodern-workspace";
+export declare function generateUltramodernWorkspace(options: UltramodernWorkspaceOptions): void;
+export declare const ultramodernWorkspaceVersions: {
+    tanstackRouter: string;
+    moduleFederation: string;
+};
+export {};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@bleedingdev/modern-js-create",
+  "description": "A Progressive React Framework for modern web development.",
+  "homepage": "https://github.com/BleedingDev/ultramodern.js#readme",
+  "bugs": {
+    "url": "https://github.com/BleedingDev/ultramodern.js/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BleedingDev/ultramodern.js.git",
+    "directory": "packages/toolkit/create"
+  },
+  "license": "MIT",
+  "keywords": [
+    "react",
+    "framework",
+    "modern",
+    "modern.js"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "version": "3.2.0-ultramodern.0",
+  "types": "./dist/types/index.d.ts",
+  "main": "./dist/index.js",
+  "bin": {
+    "create": "bin/run.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "template",
+    "template-workspace",
+    "dist",
+    "bin.js"
+  ],
+  "devDependencies": {
+    "@rslib/core": "0.21.5",
+    "@types/node": "^25.8.0",
+    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+    "tsx": "^4.22.0",
+    "@modern-js/i18n-utils": "npm:@bleedingdev/modern-js-i18n-utils@3.2.0-ultramodern.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "modern:source": "./src/index.ts",
+  "scripts": {
+    "build": "rslib build && pnpm -w tsgo:dts \"$PWD\"",
+    "dev": "rslib build -w",
+    "start": "node ./dist/index.js"
+  }
+}

package/template/.browserslistrc

@@ -0,0 +1,4 @@
+chrome >= 87
+edge >= 88
+firefox >= 78
+safari >= 14

package/template/.github/workflows/ultramodern-gates.yml.handlebars

@@ -0,0 +1,30 @@
+name: Ultramodern Gates
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  ultramodern-gates:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: pnpm
+
+      - name: Install Dependencies
+        run: pnpm install
+
+      - name: Validate Ultramodern Contract
+        run: pnpm run ultramodern:check
+
+      - name: Build
+        run: pnpm run build

package/template/.gitignore.handlebars

@@ -0,0 +1,30 @@
+.DS_Store
+
+.pnp
+.pnp.js
+.env.local
+.env.*.local
+.history
+*.log*
+
+node_modules/
+.yarn-integrity
+.pnpm-store/
+*.tsbuildinfo
+.changeset/pre.json
+
+dist/
+coverage/
+release/
+output/
+output_resource/
+log/
+
+.vscode/**/*
+!.vscode/settings.json
+!.vscode/extensions.json
+.idea/
+
+**/*/typings/auto-generated
+
+modern.config.local.*

package/template/.nvmrc

@@ -0,0 +1,2 @@
+lts/jod
+

package/template/README.md

@@ -0,0 +1,78 @@
+# Modern.js `presetUltramodern` Starter
+
+## Setup
+
+Install the dependencies:
+
+```bash
+pnpm install
+```
+
+## Get Started
+
+Start the dev server:
+
+```bash
+pnpm dev
+```
+
+Build the app for production:
+
+```bash
+pnpm build
+```
+
+Validate the generated Ultramodern preset contract locally:
+
+```bash
+pnpm run ultramodern:check
+```
+
+The generated preset defaults are opt-out. Disable specific contracts via env vars:
+
+```bash
+MODERN_BASELINE_ENABLE_MF_SSR=false
+MODERN_BASELINE_ENABLE_BFF_REQUEST_ID=false
+MODERN_BASELINE_ENABLE_TELEMETRY_EXPORTERS=false
+```
+
+The generated starter also includes `.github/workflows/ultramodern-gates.yml`.
+That workflow runs `pnpm run ultramodern:check` and `pnpm run build` on every
+push and pull request so the `presetUltramodern(...)` contract stays explicit.
+
+## Micro Vertical Workspaces
+
+Inside a Micro Vertical workspace, generate shell, remote, and service packages
+with `--sub` so the workspace root owns package-manager and CI policy:
+
+```bash
+npx @modern-js/create apps/shell --router tanstack --tailwind --workspace --sub
+npx @modern-js/create apps/remotes/catalog --router tanstack --tailwind --workspace --sub
+npx @modern-js/create apps/remotes/design-system --router tanstack --tailwind --workspace --sub
+npx @modern-js/create services/catalog-api --bff-runtime effect --workspace --sub
+```
+
+The canonical topology is documented in
+`docs/super-app-rfc-adr/WORKSPACE-0001-micro-vertical-workspace-scaffolding.md`.
+Shell packages own route assembly and topology selection, remote packages own
+route subtrees and degraded UI, service packages own Effect or explicit Hono
+contracts, and shared packages are limited to tokens, primitives, generated
+clients, or domain-neutral utilities.
+
+If the design system needs independent deployment, keep it as a horizontal
+Module Federation remote with the same topology, trust, SSR compatibility, and
+fallback rules as the vertical remotes. Do not add a second preset or a
+design-system-specific framework mode.
+
+The public opinionated entrypoint is `presetUltramodern(...)`. The older
+`withAppBaseline(...)` helper remains only as a compatibility alias.
+
+Preview the production build locally:
+
+```bash
+pnpm serve
+```
+
+For more information, see the
+[UltraModern.js guide](https://modernjs.dev/en/guides/get-started/ultramodern.html)
+and the [Modern.js documentation](https://modernjs.dev/en).

package/template/api/effect/index.ts.handlebars

@@ -0,0 +1,61 @@
+{{#if useEffectBff}}import {
+  Effect,
+  HttpApiBuilder,
+  Layer,
+  Schema,
+  ServiceMap,
+  defineEffectBff,
+} from '@modern-js/plugin-bff/effect-server';
+import { bffEffectApi } from '../../shared/effect/api';
+
+class GreetingUnavailableError extends Schema.TaggedError<GreetingUnavailableError>()(
+  'GreetingUnavailableError',
+  {
+    message: Schema.String,
+  },
+) {}
+
+class GreetingService extends ServiceMap.Service<GreetingService>()('GreetingService', {
+  make: Effect.succeed({
+    hello: Effect.fn('GreetingService.hello')(function* () {
+      if (Date.now() < 0) {
+        return yield* Effect.fail(
+          new GreetingUnavailableError({
+            message: 'Greeting service is unavailable',
+          }),
+        );
+      }
+
+      return {
+        message: 'Hello from Effect HttpApi',
+        runtime: 'effect' as const,
+      };
+    }),
+  }),
+}) {
+  static readonly layer = Layer.effect(this, this.make);
+}
+
+const greetingsLayer = HttpApiBuilder.group(bffEffectApi, 'greetings', handlers =>
+  handlers.handle('hello', () =>
+    GreetingService.use(service => service.hello()).pipe(
+      Effect.catchTag('GreetingUnavailableError', error =>
+        Effect.succeed({
+          message: error.message,
+          runtime: 'effect' as const,
+        }),
+      ),
+    ),
+  ),
+);
+
+const layer = HttpApiBuilder.layer(bffEffectApi).pipe(
+  Layer.provide(greetingsLayer),
+  Layer.provide(GreetingService.layer),
+);
+
+export default defineEffectBff({
+  api: bffEffectApi,
+  layer,
+});
+{{/if}}

package/template/api/lambda/hello.ts.handlebars

@@ -0,0 +1,6 @@
+{{#if useHonoBff}}export default async () => {
+  return {
+    message: 'Hello from Modern.js BFF ({{bffRuntime}})',
+  };
+};
+{{/if}}

package/template/biome.json

@@ -0,0 +1,41 @@
+{
+  "root": false,
+  "$schema": "https://biomejs.dev/schemas/2.4.15/schema.json",
+  "vcs": {
+    "enabled": true,
+    "defaultBranch": "main",
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "arrowParentheses": "asNeeded",
+      "jsxQuoteStyle": "double",
+      "lineWidth": 80
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "suspicious": {
+        "noDuplicateFontNames": "off"
+      }
+    }
+  },
+  "assist": { "actions": { "source": { "organizeImports": "on" } } },
+  "files": {
+    "ignoreUnknown": true,
+    "includes": [
+      "**",
+      "!**/.vscode/**/*",
+      "!**/node_modules/**/*",
+      "!**/dist/**/*"
+    ]
+  }
+}

package/template/modern.config.ts.handlebars

@@ -0,0 +1,50 @@
+import { appTools, defineConfig, presetUltramodern } from '@modern-js/app-tools';
+import path from 'node:path';
+{{#if enableBff}}import { bffPlugin } from '@modern-js/plugin-bff';
+{{/if}}{{#if isTanstackRouter}}import { tanstackRouterPlugin } from '@modern-js/plugin-tanstack';
+{{/if}}
+
+const appId = process.env.MODERN_BASELINE_APP_ID || path.basename(process.cwd());
+const enableModuleFederationSSR =
+  process.env.MODERN_BASELINE_ENABLE_MF_SSR !== 'false';
+const enableBffRequestId =
+  process.env.MODERN_BASELINE_ENABLE_BFF_REQUEST_ID !== 'false';
+const enableTelemetryExporters =
+  process.env.MODERN_BASELINE_ENABLE_TELEMETRY_EXPORTERS !== 'false';
+const telemetryFailLoudStartup =
+  process.env.MODERN_TELEMETRY_FAIL_LOUD_STARTUP !== 'false';
+
+// https://modernjs.dev/en/configure/app/usage
+export default defineConfig(
+  presetUltramodern(
+    {
+      plugins: [
+        appTools(),
+{{#if isTanstackRouter}}
+        tanstackRouterPlugin(),
+{{/if}}{{#if enableBff}}
+        bffPlugin(),
+{{/if}}
+      ],
+{{#if enableBff}}
+      bff: {
+        runtimeFramework: '{{bffRuntime}}',
+{{#if useEffectBff}}
+        effect: {
+          openapi: true,
+        },
+{{/if}}
+      },
+{{/if}}
+    },
+    {
+      appId,
+      enableBffRequestId,
+      enableModuleFederationSSR,
+      enableTelemetryExporters,
+      telemetryFailLoudStartup,
+      otlpEndpoint: process.env.MODERN_TELEMETRY_OTLP_ENDPOINT,
+      victoriaMetricsEndpoint: process.env.MODERN_TELEMETRY_VICTORIA_ENDPOINT,
+    },
+  ),
+);

package/template/package.json.handlebars

@@ -0,0 +1,47 @@
+{
+  "name": "{{packageName}}",
+  "version": "0.1.0",
+  "scripts": {
+    "reset": "npx rimraf node_modules ./**/node_modules",
+    "dev": "modern dev",
+    "build": "modern build",
+    "serve": "modern serve",
+    "ultramodern:check": "node ./scripts/validate-ultramodern.mjs"{{#unless isSubproject}},
+    "lint": "biome check",
+    "prepare": "simple-git-hooks"{{/unless}}
+  },
+  "engines": {
+    "node": ">=20"
+  }{{#unless isSubproject}},
+  "lint-staged": {
+    "*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+      "biome check --files-ignore-unknown=true"
+    ]
+  },
+  "simple-git-hooks": {
+    "pre-commit": "npx lint-staged"
+  }{{/unless}},
+  "dependencies": {
+    "@modern-js/runtime": "{{version}}"{{#if isTanstackRouter}},
+    "@modern-js/plugin-tanstack": "{{version}}",
+    "@tanstack/react-router": "1.170.1"{{/if}},
+    "react": "^19.2.3",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@modern-js/app-tools": "{{version}}",
+    "@modern-js/tsconfig": "{{version}}"{{#if enableBff}},
+    "@modern-js/plugin-bff": "{{version}}"{{/if}}{{#if enableTailwind}},
+    "@tailwindcss/postcss": "^4.1.18",
+    "postcss": "^8.5.6",
+    "tailwindcss": "^4.1.18"{{/if}}{{#unless isSubproject}},
+    "@biomejs/biome": "1.9.4"{{/unless}},
+    "@typescript/native-preview": "7.0.0-dev.20260516.1",
+    "@types/node": "^20",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6"{{#unless isSubproject}},
+    "lint-staged": "~15.4.0",
+    "simple-git-hooks": "^2.11.1"{{/unless}},
+    "rimraf": "^6.0.1"
+  }
+}

package/template/postcss.config.mjs.handlebars

@@ -0,0 +1,6 @@
+{{#if enableTailwind}}export default {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};
+{{/if}}