Merge pull request #9 from shellui-dev/feat/cli-init-create-mode

fix(cli): first-consumer polish - templates, theme sync, footer extraction

Author: Shewart

Directory.Build.props

@@ -18,6 +18,7 @@
 
   <!-- Package metadata (applies to any project with IsPackable=true) -->
   <PropertyGroup>
+    <Version>0.1.0-alpha</Version>
     <Authors>ShellUI</Authors>
     <Company>ShellUI</Company>
     <Copyright>Copyright © 2026 ShellUI</Copyright>

docs/ROADMAP.md

@@ -105,6 +105,12 @@ Ships to `ShellDocs.Components`.
 - Handles `razor:preview` blocks — code visible in Preview + Code tabs (`<DocsTabs>` primitive comes in Phase 2)
 
 ### ✅ `feat/cli-init` — shipped
+
+### ✅ `feat/cli-init-create-mode` — shipped
+Split `shelldocs init` into two modes:
+- **create** (default) — runs `dotnet new blazor` in `docs/<CwdName>.Docs`, then directly patches Program.cs + App.razor + adds packages + drops content/DocsPage.razor. One-command scaffold.
+- **attach** (`--attach`) — the old behaviour; augments an existing csproj and emits `SHELLDOCS_SETUP.md` for manual patching (safer for projects with custom auth/middleware).
+Both idempotent. Tests: 12 (4 attach + 4 patcher + 4 fixture-verified).
 Ships to `ShellDocs.CLI` + `ShellDocs.Templates`.
 
 - `shelldocs init` — detects Blazor WASM project, adds package references, generates `content/`, `Layout/DocsLayout.razor`, patches `Program.cs` to register services, writes default `meta.json`

examples/ShellDocs.Preview/Components/Pages/Blog.razor

@@ -32,6 +32,8 @@
     </div>
 </div>
 
+<DocsFooter Version="0.1.0-alpha" TwitterHandle="shellui_" />
+
 @code {
     private record Post(string Title, string Excerpt, string Tag, string Date, string Author, string AuthorInitials, string AvatarBg, string ReadTime, string Href);
 

examples/ShellDocs.Preview/Components/Pages/Home.razor

@@ -202,6 +202,27 @@ Works in Server, WASM, and static output.
     </div>
 </section>
 
+<DocsFooter Version="0.1.0-alpha" TwitterHandle="shellui_">
+    <Columns>
+        <div class="docs-footer-col">
+            <h3>Resources</h3>
+            <ul>
+                <li><a href="/docs/introduction">Documentation</a></li>
+                <li><a href="/showcase">Showcase</a></li>
+                <li><a href="/blog">Blog</a></li>
+            </ul>
+        </div>
+        <div class="docs-footer-col">
+            <h3>Support</h3>
+            <ul>
+                <li><a href="https://github.com/shellui-dev/shelldocs/issues" target="_blank" rel="noopener">Request feature</a></li>
+                <li><a href="https://github.com/shellui-dev/shelldocs/issues" target="_blank" rel="noopener">Report bug</a></li>
+                <li><a href="/sponsors">Sponsor</a></li>
+            </ul>
+        </div>
+    </Columns>
+</DocsFooter>
+
 <style>
     /* Hero — bordered rounded frame with looping video bg + content overlay.
        Copied from the ShellUI docs home. */

examples/ShellDocs.Preview/Components/Pages/Showcase.razor

@@ -49,6 +49,8 @@
     </div>
 </div>
 
+<DocsFooter Version="0.1.0-alpha" TwitterHandle="shellui_" />
+
 @code {
     private record Site(string Name, string Description, string Url, string PreviewBg, string Accent);