@icebreakers/monorepo-templates 1.3.0 → 1.3.2

package/templates/vitepress/.vitepress/theme/home/responsive.css

@@ -1,49 +1,142 @@
-@media (max-width: 900px) {
-  .repoctl-home__hero,
-  .repoctl-home__quickstart {
+@media (max-width: 1023px) {
+  .repoctl-home__hero {
     grid-template-columns: 1fr;
+    gap: 44px;
     min-height: auto;
-    padding-top: 42px;
   }
 
-  .repoctl-home__quickstart .repoctl-home__button {
-    grid-column: auto;
+  .repoctl-home__hero-copy {
+    max-width: 760px;
+  }
+
+  .repoctl-home__hero-visual {
+    width: min(100%, 760px);
+    aspect-ratio: 1.65;
+  }
+
+  .repoctl-home__hero-visual img {
+    width: 112%;
+  }
+
+  .repoctl-home__evidence {
+    grid-template-columns: 1fr;
+    gap: 36px;
   }
 
-  .repoctl-home__lifecycle ol {
-    grid-template-columns: repeat(2, 1fr);
+  .repoctl-home__workflow {
+    min-height: 260px;
   }
 }
 
-@media (max-width: 640px) {
+@media (max-width: 767px) {
   .repoctl-home {
-    padding: 16px 20px 68px;
+    padding: 16px 20px 76px;
+  }
+
+  .repoctl-home__hero {
+    gap: 32px;
+    padding: 36px 0 52px;
   }
 
   .repoctl-home__hero h1 {
-    font-size: 42px;
+    font-size: clamp(38px, 11.5vw, 48px);
+    line-height: 1.04;
+  }
+
+  .repoctl-home__lede {
+    margin-top: 20px !important;
+    font-size: 16px;
+  }
+
+  .repoctl-home__hero-actions {
+    margin-top: 28px;
+  }
+
+  .repoctl-home__button {
+    flex: 1 1 140px;
+  }
+
+  .repoctl-home__hero-visual {
+    aspect-ratio: 1.18;
+  }
+
+  .repoctl-home__hero-visual img {
+    width: 150%;
   }
 
   .repoctl-home__section {
-    padding-top: 64px;
+    padding-top: 76px;
   }
 
-  .repoctl-home__lifecycle ol,
-  .repoctl-home__path-grid,
-  .repoctl-home__automation,
-  .repoctl-home__commands dl,
-  .repoctl-home__docs > div,
-  .repoctl-home__capability-grid {
+  .repoctl-home__section-heading {
+    margin-bottom: 28px;
+  }
+
+  .repoctl-home__task-list {
     grid-template-columns: 1fr;
+    gap: 12px;
   }
 
-  .repoctl-home__automation {
+  .repoctl-home__task,
+  .repoctl-home__task:nth-child(4n + 1),
+  .repoctl-home__task:nth-child(4n) {
+    grid-column: auto;
+    min-height: 196px;
     padding: 24px;
   }
+
+  .repoctl-home__task-copy {
+    margin-top: 22px;
+  }
+
+  .repoctl-home__steps {
+    grid-template-columns: 1fr;
+  }
+
+  .repoctl-home__steps li,
+  .repoctl-home__steps li + li {
+    min-height: auto;
+    padding: 24px 0;
+    border-left: 0;
+  }
+
+  .repoctl-home__steps li + li {
+    border-top: 1px solid var(--repoctl-line);
+  }
+
+  .repoctl-home__workflow {
+    gap: 10px;
+    min-height: 250px;
+    padding: 24px 20px;
+  }
+
+  .repoctl-home__workflow pre {
+    font-size: 12px;
+    line-height: 2;
+  }
+
+  .repoctl-home__layer-list {
+    grid-template-rows: auto;
+    grid-template-columns: 1fr;
+    gap: 12px;
+  }
+
+  .repoctl-home__layer,
+  .repoctl-home__layer:first-child {
+    grid-row: auto;
+    min-height: 190px;
+    padding: 24px;
+  }
+
+  .repoctl-home__layer:first-child h3 {
+    font-size: 24px;
+  }
 }
 
 @media (prefers-reduced-motion: reduce) {
-  .repoctl-home__button {
+  .repoctl-home__button,
+  .repoctl-home__task,
+  .repoctl-home__layer {
     transition: none;
   }
 }

package/templates/vitepress/.vitepress/theme/home/sections.css

@@ -1,153 +1,232 @@
-.repoctl-home__path-grid,
-.repoctl-home__automation {
+.repoctl-home__task-list {
   display: grid;
-  grid-template-columns: repeat(2, minmax(0, 1fr));
-  gap: 20px;
+  grid-template-columns: repeat(12, minmax(0, 1fr));
+  gap: 16px;
 }
 
-.repoctl-home__path-grid article {
+.repoctl-home__task {
+  display: flex;
+  flex-direction: column;
+  grid-column: span 5;
+  min-height: 210px;
   padding: 28px;
-  background: color-mix(in srgb, var(--vp-c-bg-soft) 72%, transparent);
-  border-left: 3px solid var(--home-accent);
+  text-decoration: none !important;
+  background: var(--repoctl-surface);
+  border: 1px solid var(--repoctl-line);
+  border-radius: 8px;
+  transition:
+    background-color 160ms ease,
+    border-color 160ms ease,
+    transform 160ms ease;
 }
 
-.repoctl-home__path-grid h3 {
-  font-size: 22px;
+.repoctl-home__task:nth-child(4n + 1),
+.repoctl-home__task:nth-child(4n) {
+  grid-column: span 7;
 }
 
-.repoctl-home__path-grid p,
-.repoctl-home__capability-grid p {
-  margin-top: 10px !important;
+.repoctl-home__task:first-child {
+  background: var(--repoctl-accent-soft);
 }
 
-.repoctl-home__path-grid pre,
-.repoctl-home__automation pre,
-.repoctl-home__quickstart pre {
-  padding: 16px;
-  margin-top: 20px !important;
-  overflow-x: auto;
-  background: var(--vp-code-block-bg);
-  border: 1px solid var(--home-border);
-  border-radius: 6px;
+.repoctl-home__task:nth-child(3) {
+  background: var(--repoctl-soft);
 }
 
-.repoctl-home__path-grid a {
-  display: inline-block;
-  margin-top: 18px;
-  font-weight: 650;
+.repoctl-home__task:hover {
+  border-color: var(--repoctl-accent);
+  transform: translateY(-2px);
 }
 
-.repoctl-home__capability-grid {
-  display: grid;
-  grid-template-columns: 1.3fr 0.7fr;
-  gap: 1px;
-  background: var(--home-border);
-  border: 1px solid var(--home-border);
+.repoctl-home__task:active {
+  transform: translateY(1px);
 }
 
-.repoctl-home__capability-grid article {
-  min-height: 152px;
-  padding: 24px;
-  background: var(--vp-c-bg);
+.repoctl-home__task > code {
+  align-self: flex-start;
+  color: var(--repoctl-accent);
 }
 
-.repoctl-home__capability-grid article:nth-child(2),
-.repoctl-home__capability-grid article:nth-child(3) {
-  background: var(--vp-c-bg-soft);
+.repoctl-home__task-copy {
+  margin-top: 28px;
 }
 
-.repoctl-home__commands dl {
-  display: grid;
-  grid-template-columns: repeat(2, minmax(0, 1fr));
-  gap: 0 32px;
-  margin: 0;
+.repoctl-home__task h3 {
+  font-size: 21px;
 }
 
-.repoctl-home__commands dl > div {
-  display: flex;
-  gap: 16px;
-  justify-content: space-between;
-  padding: 16px 0;
-  border-bottom: 1px solid var(--home-border);
+.repoctl-home__task p {
+  max-width: 48ch;
+  margin-top: 8px !important;
+  font-size: 14px;
 }
 
-.repoctl-home__commands dd {
-  margin: 0;
-  color: var(--home-muted);
-  text-align: right;
+.repoctl-home__task-link,
+.repoctl-home__text-link {
+  font-size: 14px;
+  font-weight: 700;
+  color: var(--repoctl-accent);
+  white-space: nowrap;
 }
 
-.repoctl-home__automation {
-  align-items: center;
-  padding: 38px;
-  background: color-mix(in srgb, var(--vp-c-bg-soft) 80%, transparent);
-  border: 1px solid var(--home-border);
-  border-radius: 6px;
+.repoctl-home__task-link {
+  padding-top: 28px;
+  margin-top: auto;
 }
 
-.repoctl-home__automation ul {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 8px 18px;
+.repoctl-home__steps {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 0;
   padding: 0;
-  color: var(--home-muted);
   list-style: none;
+  border-top: 1px solid var(--repoctl-line);
+  border-bottom: 1px solid var(--repoctl-line);
 }
 
-.repoctl-home__automation li::before {
-  display: inline-block;
-  width: 6px;
-  height: 6px;
-  margin-right: 7px;
-  content: ' ';
-  background: var(--home-accent);
-  border-radius: 50%;
+.repoctl-home__steps li {
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr);
+  gap: 18px;
+  min-height: 238px;
+  padding: 30px 30px 30px 0;
+}
+
+.repoctl-home__steps li + li {
+  padding-left: 30px;
+  border-left: 1px solid var(--repoctl-line);
+}
+
+.repoctl-home__step-number {
+  padding-top: 3px;
+  font-family: var(--vp-font-family-mono);
+  font-size: 12px;
+  font-weight: 700;
+  color: var(--repoctl-accent);
+}
+
+.repoctl-home__steps h3 {
+  font-size: 21px;
+}
+
+.repoctl-home__steps code {
+  display: block;
+  margin-top: 18px;
+  color: var(--repoctl-accent);
+  overflow-wrap: anywhere;
+  white-space: normal;
 }
 
-.repoctl-home__automation pre,
-.repoctl-home__quickstart pre {
-  margin: 0 !important;
+.repoctl-home__steps p {
+  margin-top: 14px !important;
+  font-size: 14px;
 }
 
-.repoctl-home__quickstart {
+.repoctl-home__evidence {
   display: grid;
-  grid-template-columns: 0.85fr 1.15fr;
-  gap: 24px;
-  align-items: end;
+  grid-template-columns: minmax(0, 0.78fr) minmax(0, 1.22fr);
+  gap: 64px;
+  align-items: center;
 }
 
-.repoctl-home__quickstart .repoctl-home__button {
-  grid-column: 2;
-  justify-self: start;
+.repoctl-home__evidence .repoctl-home__text-link {
+  display: inline-block;
+  margin-top: 24px;
 }
 
-.repoctl-home__docs > div {
+.repoctl-home__workflow {
+  position: relative;
   display: grid;
-  grid-template-columns: repeat(3, minmax(0, 1fr));
-  gap: 1px;
-  background: var(--home-border);
-  border: 1px solid var(--home-border);
+  grid-template-columns: auto minmax(0, 1fr);
+  gap: 14px;
+  align-items: start;
+  min-height: 310px;
+  padding: 34px;
+  color: var(--repoctl-code-text);
+  background: var(--repoctl-code);
+  border: 1px solid var(--repoctl-line);
+  border-radius: 8px;
+  box-shadow: var(--repoctl-shadow);
+}
+
+.repoctl-home__workflow-prompt {
+  font-family: var(--vp-font-family-mono);
+  font-weight: 800;
+  color: #70d7ff;
+}
+
+.repoctl-home__workflow pre {
+  min-width: 0;
+  padding: 0;
+  overflow-x: auto;
+  font-size: 14px;
+  line-height: 2.15;
+  color: inherit;
+  background: transparent;
+}
+
+.repoctl-home__workflow code {
+  display: block;
+  color: inherit;
+  overflow-wrap: anywhere;
+  white-space: pre-wrap;
+}
+
+.repoctl-home__layer-list {
+  display: grid;
+  grid-template-rows: repeat(2, minmax(0, 1fr));
+  grid-template-columns: minmax(0, 1.15fr) minmax(0, 0.85fr);
+  gap: 16px;
 }
 
-.repoctl-home__docs a {
-  min-height: 144px;
-  padding: 20px;
+.repoctl-home__layer {
+  display: flex;
+  flex-direction: column;
+  min-height: 156px;
+  padding: 26px;
   text-decoration: none !important;
-  background: var(--vp-c-bg);
+  background: var(--repoctl-surface);
+  border: 1px solid var(--repoctl-line);
+  border-radius: 8px;
+  transition:
+    background-color 160ms ease,
+    border-color 160ms ease,
+    transform 160ms ease;
 }
 
-.repoctl-home__docs a:hover {
-  background: var(--vp-c-bg-soft);
+.repoctl-home__layer:first-child {
+  grid-row: 1 / 3;
+  min-height: 328px;
+  padding: 34px;
+  background: var(--repoctl-accent-soft);
 }
 
-.repoctl-home__docs strong,
-.repoctl-home__docs span {
-  display: block;
+.repoctl-home__layer:hover {
+  border-color: var(--repoctl-accent);
+  transform: translateY(-2px);
+}
+
+.repoctl-home__layer:active {
+  transform: translateY(1px);
+}
+
+.repoctl-home__layer h3 {
+  max-width: 18ch;
+  font-size: 22px;
+  color: var(--repoctl-accent);
+}
+
+.repoctl-home__layer:first-child h3 {
+  font-size: 30px;
 }
 
-.repoctl-home__docs span {
-  margin-top: 8px;
+.repoctl-home__layer p {
+  max-width: 48ch;
+  margin-top: 10px !important;
   font-size: 14px;
-  line-height: 1.55;
-  color: var(--home-muted);
+}
+
+.repoctl-home__layer .repoctl-home__text-link {
+  padding-top: 24px;
+  margin-top: auto;
 }

package/templates/vitepress/.vitepress/theme/index.ts

@@ -1,11 +1,13 @@
 import type { EnhanceAppContext, Theme } from 'vitepress'
 import DefaultTheme from 'vitepress/theme'
 import HomePage from './components/HomePage.vue'
+import Layout from './Layout.vue'
 import './tailwind.css'
 import './home/index.css'
 
 export default {
   ...DefaultTheme,
+  Layout,
   enhanceApp({ app }: EnhanceAppContext) {
     app.component('HomePage', HomePage)
   },

package/templates/vitepress/learn/index.md

@@ -0,0 +1,18 @@
+# Learn the system
+
+Use Learn after the first workflow works. These pages explain the boundaries around repoctl, monorepos, packages, templates, and the tools that run underneath.
+
+## Concepts
+
+- [How repoctl fits into a repository](./repoctl-model)
+- [Monorepo foundations](./monorepo/)
+- [Modern npm packages](./packages/)
+- [Template systems](./monorepo/templates)
+
+## Tools
+
+The [tool guides](./tools/) explain pnpm, Turborepo, versioning, hooks, staged checks, and dependency automation.
+
+## Reading order
+
+Start with the repository model, then choose either monorepo foundations or package publishing. Return to the [tasks](/tasks/) section whenever you need an executable sequence.

package/templates/vitepress/{monorepo → learn/monorepo}/commands.md

@@ -13,4 +13,4 @@
 
 One command layer matters because scripts, documentation, CI, and contributor expectations otherwise drift independently. repoctl keeps task names stable while pnpm and Turborepo continue to perform dependency installation and task execution.
 
-See the complete [repoctl command reference](../repoctl/commands.md).
+See the complete [repoctl command reference](/reference/commands).

package/templates/vitepress/{monorepo → learn/monorepo}/index.md

@@ -32,6 +32,6 @@ repoctl adds the missing workflow layer:
 
 ## Keep Reading
 
-- [repoctl Overview](../repoctl/index.md)
-- [Command Reference](../repoctl/commands.md)
-- [Templates](../repoctl/templates.md)
+- [repoctl Overview](/learn/repoctl-model)
+- [Command Reference](/reference/commands)
+- [Templates](/reference/templates)

package/templates/vitepress/{monorepo → learn/monorepo}/templates.md

@@ -11,4 +11,4 @@ repo templates --check
 
 The publishable `@icebreakers/monorepo-templates` package owns the registry and packaged assets. Individual `templates/*` workspaces are private and are not release units.
 
-See [Templates](../repoctl/templates.md) and [Template Asset Management](../repoctl/template-assets.md).
+See [Templates](/reference/templates) and [Template Asset Management](/reference/template-assets).

package/templates/vitepress/{why/what-is-npm-package.md → learn/packages/index.md}

@@ -32,5 +32,5 @@ Repository versioning tools record that decision, but they cannot determine whet
 
 ## Keep Reading
 
-- [Publishing A Package](./publish-basic-npm-package.md)
+- [Publishing A Package](/learn/packages/publish)
 - [Modern Package Guide](./modern/)

package/templates/vitepress/{why → learn/packages}/modern/index.md

@@ -34,5 +34,5 @@ Use `files` to publish only the built output and deliberately included documenta
 
 ## Keep Reading
 
-- [What Is An npm Package?](../what-is-npm-package.md)
-- [Publishing A Package](../publish-basic-npm-package.md)
+- [What Is An npm Package?](/learn/packages/)
+- [Publishing A Package](/learn/packages/publish)

package/templates/vitepress/{why → learn/packages}/modern/typescript.md

@@ -40,4 +40,4 @@ For local scripts, `tsx` can run TypeScript without creating a development `dist
 
 - [Type Declarations](./dts.md)
 - [Bundlers](./bundlers.md)
-- [Publishing A Package](../publish-basic-npm-package.md)
+- [Publishing A Package](/learn/packages/publish)

package/templates/vitepress/{why/index.md → learn/packages/modern-overview.md}

@@ -11,4 +11,4 @@ A modern package needs a deliberate module format, export map, declaration strat
 - [Bundlers](./modern/bundlers.md)
 - [TypeScript](./modern/typescript.md)
 
-Runnable evolution examples remain under `why/examples/` and are intentionally excluded from the generated AI documentation index.
+Runnable evolution examples remain under `learn/packages/examples/` and are intentionally excluded from the generated AI documentation index.

package/templates/vitepress/{why/publish-basic-npm-package.md → learn/packages/publish.md}

@@ -39,5 +39,5 @@ The version ledger preserves why the release exists. Do not manually edit a pack
 
 ## Keep Reading
 
-- [pnpm Versioning](../tools/changeset.md)
+- [pnpm Versioning](/learn/tools/changeset.md)
 - [Modern Package Guide](./modern/)

package/templates/vitepress/{why/how-to-reuse-js-code.md → learn/packages/reuse-javascript.md}

@@ -35,5 +35,5 @@ Keep the public entry point small. A shared package should expose behavior that
 
 ## Keep Reading
 
-- [What Is An npm Package?](./what-is-npm-package.md)
-- [Template Systems](../monorepo/templates.md)
+- [What Is An npm Package?](/learn/packages/)
+- [Template Systems](/learn/monorepo/templates.md)

package/templates/vitepress/{why/js-keywords.md → learn/packages/runtime-globals.md}

@@ -32,5 +32,5 @@ Use `import.meta.url` as the starting point for resolving files relative to an E
 
 ## Keep Reading
 
-- [JavaScript, CommonJS, and ESM Files](./js-cjs-mjs.md)
-- [Reusing JavaScript](./how-to-reuse-js-code.md)
+- [JavaScript, CommonJS, and ESM Files](/learn/packages/module-extensions)
+- [Reusing JavaScript](/learn/packages/reuse-javascript)

package/templates/vitepress/{repoctl/index.md → learn/repoctl-model.md}

@@ -64,11 +64,11 @@ The docs prefer `repo` so new users only need to remember one command name.
 
 ## Keep Reading
 
-- [Getting Started](./getting-started.md)
-- [Choose By Scenario](./scenarios.md)
-- [Command Reference](./commands.md)
-- [Configuration](./config.md)
-- [Templates](./templates.md)
-- [Workflows and CI](./workflows.md)
-- [Troubleshooting](./troubleshooting.md)
-- [Command Aliases](./aliases.md)
+- [Install and initialize](/start/install)
+- [Task index](/tasks/)
+- [Command Reference](/reference/commands)
+- [Configuration](/reference/config)
+- [Templates](/reference/templates)
+- [Add checks to CI](/tasks/ci)
+- [Troubleshoot](/tasks/troubleshooting)
+- [Command Aliases](/reference/aliases)

package/templates/vitepress/{tools → learn/tools}/changeset.md

@@ -25,6 +25,6 @@ Some packages version together because they share a public contract. The version
 
 ## Keep Reading
 
-- [Publishing and Changelogs](../monorepo/publish.md)
-- [Workflows and CI](../repoctl/workflows.md)
-- [Template Assets](../repoctl/template-assets.md)
+- [Publishing and Changelogs](/learn/monorepo/publish.md)
+- [Add checks to CI](/tasks/ci)
+- [Template Assets](/reference/template-assets)

package/templates/vitepress/{tools → learn/tools}/husky.md

@@ -46,5 +46,5 @@ The initializer creates `.husky/pre-commit`. Replace its generated command with
 ## Keep Reading
 
 - [lint-staged](./lint-staged.md)
-- [Workflows and CI](../repoctl/workflows.md)
-- [Verification](../repoctl/checks.md)
+- [Add checks to CI](/tasks/ci)
+- [Verification](/tasks/checks)

package/templates/vitepress/{tools → learn/tools}/lint-staged.md

@@ -35,5 +35,5 @@ The hook selects repoctl's pre-commit workflow. That workflow can call lint-stag
 ## Keep Reading
 
 - [Husky](./husky.md)
-- [Verification](../repoctl/checks.md)
-- [Workflows and CI](../repoctl/workflows.md)
+- [Verification](/tasks/checks)
+- [Add checks to CI](/tasks/ci)

package/templates/vitepress/{tools → learn/tools}/llms-txt.md

@@ -4,4 +4,4 @@
 
 This site generates an English-default `/llms.txt` and a larger `/llms-full.txt`. Simplified Chinese content is namespaced under `/zh/`, and historical or internal files are excluded from the index.
 
-See the [repoctl AI documentation](../ai/llms-txt.md) for URLs and maintenance rules.
+See the [repoctl AI documentation](/ai/llms-txt) for URLs and maintenance rules.