From 007f690ff3e324f7ffe2ee8dad4a13e3742b25d5 Mon Sep 17 00:00:00 2001
From: Mamadou Talla DIA <ibntalla@gmail.com>
Date: Wed, 9 Sep 2026 20:09:30 +0100
Subject: [PATCH 1/4] =?UTF-8?q?feat:=20ajouter=20la=20version=20stable=201?=
 =?UTF-8?q?.0.0=20au=20changelog=20avec=20des=20d=C3=A9tails=20sur=20les?=
 =?UTF-8?q?=20fonctionnalit=C3=A9s=20et=20les=20am=C3=A9liorations?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 website/app/pages/changelog.vue | 43 ++++++++++++++++++++++++++++++---
 1 file changed, 40 insertions(+), 3 deletions(-)

diff --git a/website/app/pages/changelog.vue b/website/app/pages/changelog.vue
index b906089..c1da190 100644
--- a/website/app/pages/changelog.vue
+++ b/website/app/pages/changelog.vue
@@ -1,12 +1,49 @@
 <script setup lang="ts">
 const releases = [
+  {
+    version: "1.0.0",
+    date: "September 9, 2026",
+    title: "Runable v1 is ready",
+    description:
+      "The first stable release brings productive Vue conventions to the server runtime your application already uses.",
+    current: true,
+    groups: [
+      {
+        type: "Framework",
+        tone: "accent",
+        items: [
+          "File-system routing, layouts, middleware, plugins, components, and composables work together through generated application code.",
+          "Server-side rendering, client-side rendering, data fetching, head management, and error handling are available as first-class application features.",
+          "Generated types keep routes, runtime configuration, modules, and auto-imported APIs visible to TypeScript and your editor.",
+        ],
+      },
+      {
+        type: "Runtimes",
+        tone: "success",
+        items: [
+          "Runable integrates with Express, Fastify, Hono, NestJS, AdonisJS, Koa, Bun, Deno, and custom servers.",
+          "Applications keep control of their backend runtime instead of adopting a framework-owned server layer.",
+          "Runtime adapters expose a consistent entry point for development and production requests.",
+        ],
+      },
+      {
+        type: "Tooling",
+        tone: "neutral",
+        items: [
+          "The Runable CLI creates applications, prepares generated files, and produces production builds.",
+          "The module system lets official and community integrations extend configuration, hooks, auto-imports, and generated types.",
+          "New projects start with a responsive welcome screen and direct links to the documentation, modules, and source code.",
+        ],
+      },
+    ],
+  },
   {
     version: "1.0.0-alpha.3",
     date: "August 19, 2026",
     title: "A more reliable foundation",
     description:
       "This release focuses on predictable builds, safer extension APIs, and cleaner generated types across minimal and advanced applications.",
-    current: true,
+    current: false,
     groups: [
       {
         type: "Fixed",
@@ -156,7 +193,7 @@ useSeoMeta({
                 Current release
               </p>
               <p class="mt-2 font-display text-2xl font-semibold">
-                v1.0.0-alpha.3
+                v1.0.0
               </p>
             </div>
             <span class="relative mt-1 flex size-2">
@@ -172,7 +209,7 @@ useSeoMeta({
             class="mt-6 flex items-center justify-between border-t border-border pt-5"
           >
             <span class="font-mono text-xs text-muted-foreground"
-              >Alpha channel</span
+              >Stable channel</span
             >
             <a
               href="https://github.com/runablejs/runable/releases"

From ef89ff3e6666ad55937024b8b69e5a26ea7429e3 Mon Sep 17 00:00:00 2001
From: Mamadou Talla DIA <ibntalla@gmail.com>
Date: Tue, 15 Sep 2026 10:40:43 +0100
Subject: [PATCH 2/4] =?UTF-8?q?refactor:=20simplifier=20la=20gestion=20des?=
 =?UTF-8?q?=20sponsors=20et=20am=C3=A9liorer=20l'animation=20de=20r=C3=A9v?=
 =?UTF-8?q?=C3=A9lation?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 website/app/components/landing/Sponsors.vue | 230 ++++++--------------
 1 file changed, 64 insertions(+), 166 deletions(-)

diff --git a/website/app/components/landing/Sponsors.vue b/website/app/components/landing/Sponsors.vue
index 35b5e7f..ced95c1 100644
--- a/website/app/components/landing/Sponsors.vue
+++ b/website/app/components/landing/Sponsors.vue
@@ -1,9 +1,7 @@
 <script setup lang="ts">
 import { onMounted, ref } from "vue";
 
-const headingRef = ref<HTMLElement | null>(null);
-const contentRef = ref<HTMLElement | null>(null);
-const licenseRef = ref<HTMLElement | null>(null);
+const sectionRef = ref<HTMLElement | null>(null);
 
 const { reveal, revealChildren } = useScrollReveal({
   threshold: 0.08,
@@ -11,183 +9,83 @@ const { reveal, revealChildren } = useScrollReveal({
   y: 16,
 });
 
-onMounted(() => {
-  reveal(headingRef.value);
-  revealChildren(contentRef.value, "[data-reveal]", 80);
-  reveal(licenseRef.value);
-});
-
-const investments = [
+const sponsors = [
   {
-    ref: "01",
-    title: "Core development",
-    description: "More time for framework APIs, stability, and performance.",
-    icon: "tabler:code",
+    name: "Render",
+    href: "https://render.com",
+    icon: "simple-icons:render",
   },
-  {
-    ref: "02",
-    title: "Documentation",
-    description:
-      "Clear guides, examples, and migration paths for every runtime.",
-    icon: "tabler:book-2",
-  },
-  {
-    ref: "03",
-    title: "Ecosystem",
-    description:
-      "Official modules, adapters, integrations, and developer tools.",
-    icon: "tabler:circles-relation",
-  },
-];
+] as const;
+
+onMounted(() => {
+  reveal(sectionRef.value);
+  revealChildren(sectionRef.value, "[data-sponsor]", 80);
+});
 </script>
 
 <template>
   <section
+    ref="sectionRef"
     aria-labelledby="sponsors-heading"
-    class="relative overflow-hidden bg-background"
+    class="sr-hidden border-y border-border bg-background"
+    style="
+      transition:
+        opacity 300ms ease-out,
+        transform 300ms ease-out;
+    "
   >
-    <div class="mx-auto max-w-7xl px-6 py-24 sm:px-10 md:py-36">
-      <div
-        ref="headingRef"
-        class="sr-hidden max-w-4xl"
-        style="
-          transition:
-            opacity 300ms ease-out,
-            transform 300ms ease-out;
-        "
+    <div class="mx-auto max-w-7xl px-6 py-20 sm:px-10 md:py-28">
+      <p
+        class="font-mono text-xs uppercase tracking-[0.18em] text-muted-foreground"
       >
-        <p
-          class="font-mono text-xs uppercase tracking-[0.18em] text-muted-foreground"
-        >
-          05 — Sponsors
-        </p>
-        <h2
-          id="sponsors-heading"
-          class="mt-6 font-display text-h2 text-neutral"
-        >
-          Back an independent<br />
-          <em class="font-display italic text-accent">Vue ecosystem.</em>
-        </h2>
-        <p class="mt-7 max-w-2xl text-lg leading-relaxed text-muted-foreground">
-          Sponsorship turns community support into focused engineering time for
-          the framework, its integrations, and the documentation around them.
-        </p>
-      </div>
+        05 — Sponsors
+      </p>
+      <h2 id="sponsors-heading" class="mt-6 font-display text-h2 text-neutral">
+        Back an independent<br />
+        <em class="font-display italic text-accent">Vue ecosystem.</em>
+      </h2>
+      <p class="mt-7 max-w-2xl text-lg leading-relaxed text-muted-foreground">
+        Sponsorship turns community support into focused engineering time for
+        the framework, its integrations, and the documentation around them.
+      </p>
 
       <div
-        ref="contentRef"
-        class="mt-16 grid border border-border md:mt-24 lg:grid-cols-5"
+        class="mt-16 grid overflow-hidden border-l border-t border-border sm:grid-cols-2 lg:grid-cols-4"
       >
-        <div
-          data-reveal
-          class="sr-hidden relative flex min-h-152 flex-col overflow-hidden bg-neutral p-6 text-inverse sm:p-10 lg:col-span-3 lg:p-12"
+        <a
+          v-for="sponsor in sponsors"
+          :key="sponsor.name"
+          data-sponsor
+          :href="sponsor.href"
+          target="_blank"
+          rel="noopener noreferrer"
+          :aria-label="`${sponsor.name} website`"
+          class="sr-hidden group flex min-h-40 items-center justify-center gap-4 border-b border-r border-border bg-background px-8 transition-colors hover:bg-muted/30"
         >
-          <div class="relative flex items-start justify-between gap-6">
-            <span
-              class="flex size-12 items-center justify-center bg-accent text-accent-foreground"
-            >
-              <UIcon name="tabler:heart-handshake" class="size-6" />
-            </span>
-            <span
-              class="border border-inverse/20 px-3 py-1.5 font-mono text-[9px] uppercase tracking-[0.18em] text-inverse/60"
-            >
-              Founding round · Open
-            </span>
-          </div>
-
-          <div class="relative mt-20 max-w-2xl lg:mt-auto">
-            <p
-              class="font-mono text-[10px] uppercase tracking-[0.2em] text-inverse/50"
-            >
-              A project worth using is a project worth sustaining
-            </p>
-            <h3
-              class="mt-5 max-w-xl font-display text-3xl font-semibold leading-tight tracking-tight sm:text-5xl"
-            >
-              Put your name behind backend freedom.
-            </h3>
-            <p class="mt-6 max-w-xl text-base leading-relaxed text-inverse/65">
-              Become one of Runable's first sponsors. Your support funds public
-              work and gives the project more room to grow without compromising
-              its runtime-independent direction.
-            </p>
-
-            <a
-              href="https://github.com/sponsors/domutala"
-              target="_blank"
-              rel="noopener noreferrer"
-              class="mt-8 inline-flex min-h-12 items-center gap-3 bg-accent px-5 font-medium text-accent-foreground"
-            >
-              <UIcon name="simple-icons:githubsponsors" class="size-4" />
-              Become a sponsor
-              <UIcon name="tabler:arrow-up-right" class="size-4" />
-            </a>
-          </div>
-        </div>
-
-        <div class="lg:col-span-2 lg:border-l lg:border-border">
-          <div
-            data-reveal
-            class="sr-hidden flex min-h-24 items-center justify-between border-b border-border px-6 sm:px-8"
-          >
-            <div>
-              <p
-                class="font-mono text-[10px] uppercase tracking-[0.18em] text-muted-foreground"
-              >
-                Impact ledger
-              </p>
-              <p class="mt-2 font-display text-lg font-semibold">
-                Where support goes
-              </p>
-            </div>
-            <span
-              class="flex items-center gap-2 font-mono text-[9px] uppercase tracking-wider text-muted-foreground"
-            >
-              <span class="size-1.5 rounded-full bg-accent" /> Public work
-            </span>
-          </div>
+          <UIcon
+            :name="sponsor.icon"
+            class="size-8 text-foreground transition-colors group-hover:text-accent"
+          />
+          <span class="font-display text-2xl font-semibold">
+            {{ sponsor.name }}
+          </span>
+        </a>
 
-          <article
-            v-for="investment in investments"
-            :key="investment.title"
-            data-reveal
-            class="sr-hidden flex min-h-44 flex-col border-b border-border p-6 last:border-b-0 sm:p-8 lg:min-h-43"
-          >
-            <div class="flex items-start justify-between gap-5">
-              <span
-                class="flex size-10 items-center justify-center border border-border text-muted-foreground"
-              >
-                <UIcon :name="investment.icon" class="size-5" />
-              </span>
-              <span class="font-mono text-[10px] text-muted-foreground">
-                IMP.{{ investment.ref }}
-              </span>
-            </div>
-            <div class="mt-auto pt-8">
-              <h3 class="font-display text-lg font-semibold">
-                {{ investment.title }}
-              </h3>
-              <p
-                class="mt-2 max-w-sm text-sm leading-relaxed text-muted-foreground"
-              >
-                {{ investment.description }}
-              </p>
-            </div>
-          </article>
-        </div>
-      </div>
-
-      <div
-        ref="licenseRef"
-        class="sr-hidden mt-6 flex flex-col gap-2 font-mono text-[10px] uppercase tracking-[0.12em] text-muted-foreground sm:flex-row sm:items-center sm:justify-between"
-        style="
-          transition:
-            opacity 300ms ease-out,
-            transform 300ms ease-out;
-        "
-      >
-        <span>Runable remains open source for everyone.</span>
-        <span>MIT licensed · Community supported</span>
+        <a
+          data-sponsor
+          href="https://github.com/sponsors/domutala"
+          target="_blank"
+          rel="noopener noreferrer"
+          aria-label="Become a Runable sponsor"
+          title="Become a sponsor"
+          class="sr-hidden group flex min-h-40 items-center justify-center border-b border-r border-border bg-background transition-colors hover:bg-accent hover:text-accent-foreground"
+        >
+          <UIcon
+            name="tabler:plus"
+            class="size-9 transition-transform group-hover:rotate-90"
+          />
+          <span class="sr-only">Become a sponsor</span>
+        </a>
       </div>
     </div>
   </section>

From c02b5de1d549382db6fcd752d313db39d83625f7 Mon Sep 17 00:00:00 2001
From: Mamadou Talla DIA <ibntalla@gmail.com>
Date: Sat, 19 Sep 2026 03:46:47 +0100
Subject: [PATCH 3/4] =?UTF-8?q?feat:=20ajouter=20des=20mod=C3=A8les=20.git?=
 =?UTF-8?q?ignore=20sp=C3=A9cifiques=20aux=20frameworks=20et=20am=C3=A9lio?=
 =?UTF-8?q?rer=20la=20gestion=20des=20alias=20de=20configuration?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .changeset/fix-starter-gitignore-packaging.md |  5 ++
 .changeset/inherit-module-aliases.md          |  5 ++
 packages/cli/src/commands/create/starter.ts   |  6 +-
 .../{.gitignore => gitignore.template}        |  2 +-
 .../{.gitignore => gitignore.template}        |  0
 .../{.gitignore => gitignore.template}        |  0
 .../hono/{.gitignore => gitignore.template}   |  0
 .../koa/{.gitignore => gitignore.template}    |  0
 .../nestjs/{.gitignore => gitignore.template} |  0
 packages/runable/src/config/load.ts           | 19 ++++-
 packages/runable/src/utils/tsconfig.ts        |  2 +-
 tests/regressions/cli-starters.test.ts        |  8 +-
 tests/regressions/module-aliases.test.ts      | 75 +++++++++++++++++++
 .../docs/en/getting-started/configuration.md  |  2 +
 .../docs/fr/getting-started/configuration.md  |  2 +
 15 files changed, 121 insertions(+), 5 deletions(-)
 create mode 100644 .changeset/fix-starter-gitignore-packaging.md
 create mode 100644 .changeset/inherit-module-aliases.md
 rename packages/cli/starters/adonisjs/{.gitignore => gitignore.template} (97%)
 rename packages/cli/starters/express/{.gitignore => gitignore.template} (100%)
 rename packages/cli/starters/fastify/{.gitignore => gitignore.template} (100%)
 rename packages/cli/starters/hono/{.gitignore => gitignore.template} (100%)
 rename packages/cli/starters/koa/{.gitignore => gitignore.template} (100%)
 rename packages/cli/starters/nestjs/{.gitignore => gitignore.template} (100%)
 create mode 100644 tests/regressions/module-aliases.test.ts

diff --git a/.changeset/fix-starter-gitignore-packaging.md b/.changeset/fix-starter-gitignore-packaging.md
new file mode 100644
index 0000000..1f59c09
--- /dev/null
+++ b/.changeset/fix-starter-gitignore-packaging.md
@@ -0,0 +1,5 @@
+---
+"@runablejs/cli": patch
+---
+
+Ensure every generated starter includes its framework-specific `.gitignore` file.
diff --git a/.changeset/inherit-module-aliases.md b/.changeset/inherit-module-aliases.md
new file mode 100644
index 0000000..789d2f9
--- /dev/null
+++ b/.changeset/inherit-module-aliases.md
@@ -0,0 +1,5 @@
+---
+"runable": patch
+---
+
+Inherit aliases declared by modules in application Vite and TypeScript resolution.
diff --git a/packages/cli/src/commands/create/starter.ts b/packages/cli/src/commands/create/starter.ts
index 2cfefe0..304c85a 100644
--- a/packages/cli/src/commands/create/starter.ts
+++ b/packages/cli/src/commands/create/starter.ts
@@ -1,4 +1,4 @@
-import { cp, mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { cp, mkdir, readFile, rename, stat, writeFile } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -75,6 +75,10 @@ export async function copyStarterTemplate(
   await mkdir(targetDir, { recursive: true });
   await cp(sharedTemplateDir, targetDir, { recursive: true, force: true });
   await cp(templateDir, targetDir, { recursive: true, force: true });
+  await rename(
+    resolve(targetDir, "gitignore.template"),
+    resolve(targetDir, ".gitignore"),
+  );
 
   const packageJsonPath = resolve(targetDir, "package.json");
   const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
diff --git a/packages/cli/starters/adonisjs/.gitignore b/packages/cli/starters/adonisjs/gitignore.template
similarity index 97%
rename from packages/cli/starters/adonisjs/.gitignore
rename to packages/cli/starters/adonisjs/gitignore.template
index 4a70e94..ae3f9fd 100644
--- a/packages/cli/starters/adonisjs/.gitignore
+++ b/packages/cli/starters/adonisjs/gitignore.template
@@ -26,4 +26,4 @@ yarn-error.log
 .DS_Store
 
 .app
-.output
\ No newline at end of file
+.output
diff --git a/packages/cli/starters/express/.gitignore b/packages/cli/starters/express/gitignore.template
similarity index 100%
rename from packages/cli/starters/express/.gitignore
rename to packages/cli/starters/express/gitignore.template
diff --git a/packages/cli/starters/fastify/.gitignore b/packages/cli/starters/fastify/gitignore.template
similarity index 100%
rename from packages/cli/starters/fastify/.gitignore
rename to packages/cli/starters/fastify/gitignore.template
diff --git a/packages/cli/starters/hono/.gitignore b/packages/cli/starters/hono/gitignore.template
similarity index 100%
rename from packages/cli/starters/hono/.gitignore
rename to packages/cli/starters/hono/gitignore.template
diff --git a/packages/cli/starters/koa/.gitignore b/packages/cli/starters/koa/gitignore.template
similarity index 100%
rename from packages/cli/starters/koa/.gitignore
rename to packages/cli/starters/koa/gitignore.template
diff --git a/packages/cli/starters/nestjs/.gitignore b/packages/cli/starters/nestjs/gitignore.template
similarity index 100%
rename from packages/cli/starters/nestjs/.gitignore
rename to packages/cli/starters/nestjs/gitignore.template
diff --git a/packages/runable/src/config/load.ts b/packages/runable/src/config/load.ts
index 818f940..43dfef4 100644
--- a/packages/runable/src/config/load.ts
+++ b/packages/runable/src/config/load.ts
@@ -496,6 +496,21 @@ export interface ConfigGraph {
   all: ResolvedConfig[];
 }
 
+/**
+ * Combines aliases from the resolved config graph. Dependencies are applied
+ * first, then their parents, and the main application last, so the closest
+ * consumer wins when two configs declare the same alias.
+ */
+function mergeConfigAliases(configs: ResolvedConfig[]) {
+  const aliases: ResolvedConfig["alias"] = {};
+
+  for (const config of [...configs].reverse()) {
+    Object.assign(aliases, config.alias);
+  }
+
+  return aliases;
+}
+
 /**
  * Resolves the full config graph for a project — the main config, every
  * module it transitively depends on, their options, and module `setup()`
@@ -585,10 +600,12 @@ export async function resolveConfigGraph(
 
   resolved = await runConfigExtensions(resolved, pendingSetups);
   const main = resolved.__main!;
+  const all = Object.values(resolved).sort((a, b) => a._index - b._index);
+
+  main.alias = mergeConfigAliases(all);
 
   await runSetups(pendingSetups, main);
 
-  const all = Object.values(resolved).sort((a, b) => a._index - b._index);
   return { main, all };
 }
 
diff --git a/packages/runable/src/utils/tsconfig.ts b/packages/runable/src/utils/tsconfig.ts
index 7a80aa3..d941838 100644
--- a/packages/runable/src/utils/tsconfig.ts
+++ b/packages/runable/src/utils/tsconfig.ts
@@ -40,7 +40,7 @@ export function writeTsConfig() {
   Object.entries(alias ?? {}).forEach(([key, value]) => {
     if (key === "#build") return;
 
-    tsconfig.app.addAlias(key, normalizeDir(relative(process.cwd(), value)));
+    tsconfig.app.addAlias(key, normalizeDir(relative(output, value)));
   });
 
   tsconfig.app.addAlias("#build", "./");
diff --git a/tests/regressions/cli-starters.test.ts b/tests/regressions/cli-starters.test.ts
index f515c24..f6c6565 100644
--- a/tests/regressions/cli-starters.test.ts
+++ b/tests/regressions/cli-starters.test.ts
@@ -17,7 +17,12 @@ describe("CLI starter templates", () => {
     it(`copies a complete ${framework} starter`, async () => {
       expect(
         existsSync(
-          join(process.cwd(), "packages/cli/starters", framework, ".gitignore"),
+          join(
+            process.cwd(),
+            "packages/cli/starters",
+            framework,
+            "gitignore.template",
+          ),
         ),
       ).toBe(true);
 
@@ -32,6 +37,7 @@ describe("CLI starter templates", () => {
 
       expect(existsSync(join(target, "package.json"))).toBe(true);
       expect(existsSync(join(target, ".gitignore"))).toBe(true);
+      expect(existsSync(join(target, "gitignore.template"))).toBe(false);
       expect(existsSync(join(target, "runable.config.ts"))).toBe(true);
       expect(existsSync(join(target, "app/app.vue"))).toBe(true);
       expect(existsSync(join(target, "app/pages/index.vue"))).toBe(true);
diff --git a/tests/regressions/module-aliases.test.ts b/tests/regressions/module-aliases.test.ts
new file mode 100644
index 0000000..897dccc
--- /dev/null
+++ b/tests/regressions/module-aliases.test.ts
@@ -0,0 +1,75 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+import {
+  cleanupFixtureDir,
+  createFixtureDir,
+  linkWorkspacePackage,
+  writeFixtureFile,
+} from "../fixtures.js";
+
+const originalCwd = process.cwd();
+
+afterEach(() => {
+  process.chdir(originalCwd);
+});
+
+describe("module aliases", () => {
+  it("adds module aliases to the application with consumer precedence", async () => {
+    const directory = createFixtureDir("module-aliases-");
+
+    try {
+      linkWorkspacePackage(directory, "runable", "packages/runable");
+      writeFixtureFile(
+        directory,
+        "runable.config.ts",
+        `import path from "node:path";
+import { defineConfig } from "runable";
+
+export default defineConfig({
+  modules: ["./module"],
+  alias: { "@shared": path.join(import.meta.dirname, "app/shared") },
+});
+`,
+      );
+      writeFixtureFile(
+        directory,
+        "module/runable.config.ts",
+        `import path from "node:path";
+import { defineModule } from "runable";
+
+export default defineModule({
+  alias: {
+    "@module": path.join(import.meta.dirname, "app"),
+    "@shared": path.join(import.meta.dirname, "app/shared"),
+  },
+});
+`,
+      );
+
+      process.chdir(directory);
+      vi.resetModules();
+      const { loadConfig, useConfig, writeTsConfig } = await import("runable");
+      await loadConfig();
+      writeTsConfig();
+
+      const config = useConfig();
+      expect(config.alias["@module"]).toBe(
+        path.join(directory, "module/app"),
+      );
+      expect(config.alias["@shared"]).toBe(path.join(directory, "app/shared"));
+      expect(config.alias["#build"]).toBe(path.join(directory, ".app"));
+
+      const generated = JSON.parse(
+        readFileSync(path.join(directory, ".app/tsconfig.app.json"), "utf8"),
+      );
+      expect(generated.compilerOptions.paths).toMatchObject({
+        "@module": ["../module/app"],
+        "@shared": ["../app/shared"],
+      });
+    } finally {
+      cleanupFixtureDir(directory);
+    }
+  });
+});
diff --git a/website/content/docs/en/getting-started/configuration.md b/website/content/docs/en/getting-started/configuration.md
index f8730d3..0c7ac3d 100644
--- a/website/content/docs/en/getting-started/configuration.md
+++ b/website/content/docs/en/getting-started/configuration.md
@@ -117,6 +117,8 @@ export default defineConfig({
 });
 ```
 
+Aliases declared by modules are inherited by the application and included in both Vite resolution and the generated `.app/tsconfig.app.json`. When aliases conflict, the application overrides its modules, and a module overrides its own dependencies.
+
 Runable also adds the internal `#build` alias, which points to the generated directory defined by `output`.
 
 ## Extend scanned directories
diff --git a/website/content/docs/fr/getting-started/configuration.md b/website/content/docs/fr/getting-started/configuration.md
index f546993..542385e 100644
--- a/website/content/docs/fr/getting-started/configuration.md
+++ b/website/content/docs/fr/getting-started/configuration.md
@@ -121,6 +121,8 @@ export default defineConfig({
 });
 ```
 
+Les alias déclarés par les modules sont hérités par l'application et ajoutés à la résolution Vite ainsi qu'au fichier `.app/tsconfig.app.json` généré. En cas de conflit, l'application est prioritaire sur ses modules, et un module est prioritaire sur ses propres dépendances.
+
 Runable ajoute aussi l'alias interne `#build`, qui pointe vers le dossier généré défini par `output`.
 
 ## Étendre les dossiers analysés

From 416d158fe85021a62c1971e4223b09d41b19b7b8 Mon Sep 17 00:00:00 2001
From: Mamadou Talla DIA <ibntalla@gmail.com>
Date: Sat, 19 Sep 2026 03:54:56 +0100
Subject: [PATCH 4/4] =?UTF-8?q?feat:=20ajouter=20un=20mod=C3=A8le=20.gitig?=
 =?UTF-8?q?nore=20pour=20les=20projets=20cr=C3=A9=C3=A9s=20=C3=A0=20partir?=
 =?UTF-8?q?=20de=20mod=C3=A8les=20de=20d=C3=A9marrage?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 tests/integration/agents-md.test.ts | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/tests/integration/agents-md.test.ts b/tests/integration/agents-md.test.ts
index fc23ac0..eee015d 100644
--- a/tests/integration/agents-md.test.ts
+++ b/tests/integration/agents-md.test.ts
@@ -76,6 +76,10 @@ describe("AGENTS.md is shipped to newly scaffolded Runable projects", () => {
         path.join(starterTemplateDir, "package.json"),
         JSON.stringify({ name: "fixture-starter", version: "1.0.0" }),
       );
+      writeFileSync(
+        path.join(starterTemplateDir, "gitignore.template"),
+        "node_modules\n.app\n.output\n",
+      );
 
       const { copyStarterTemplate } = await import(
         "../../packages/cli/dist/commands/create/starter.js"
@@ -95,6 +99,10 @@ describe("AGENTS.md is shipped to newly scaffolded Runable projects", () => {
       // The starter template itself is still there too — copyAgentsFile
       // must not have clobbered anything from copyStarterTemplate.
       expect(existsSync(path.join(projectDir, "package.json"))).toBe(true);
+      expect(existsSync(path.join(projectDir, ".gitignore"))).toBe(true);
+      expect(existsSync(path.join(projectDir, "gitignore.template"))).toBe(
+        false,
+      );
     } finally {
       rmSync(starterTemplateDir, { recursive: true, force: true });
       cleanupFixtureDir(projectDir);