Merge pull request #49 from Mastersam07/feat/docs-site

feat: docs site

Author: Mastersam07

assets/brand/README.md

@@ -10,7 +10,8 @@ of them, then re-render with `rsvg-convert` (see commands below).
 | `kaisel-icon.svg` | Master mark on the dark tile. Source of truth. |
 | `kaisel-icon-1024.png` | Hi-res square tile. Downscale for any avatar or icon slot. |
 | `kaisel-icon-rounded.svg/png` | App-icon tile with rounded corners. Avatars: X, Discord, Medium, pub.dev publisher. |
-| `kaisel-mark.svg/png` | Transparent mark. Package READMEs (core, lint, devtools); anywhere the background should show through. |
+| `kaisel-mark.svg/png` | Transparent mark for dark backgrounds. Package READMEs (core, lint, devtools); docs-site logo and hero (dark theme). |
+| `kaisel-mark-light.svg/png` | Transparent mark with a deepened ramp for white backgrounds. Docs-site logo and hero (light theme). |
 | `kaisel-logo-dark.svg/png` | Transparent lockup, white wordmark. README headers on dark backgrounds. |
 | `kaisel-logo-light.svg/png` | Transparent lockup, slate wordmark. README headers on light backgrounds. |
 | `kaisel-banner.png` | Lockup on the dark tile. dev.to covers, Medium headers, slides — wide slots that want a baked background. |

assets/brand/kaisel-mark-light.png

@@ -14,9 +14,9 @@ your migration branch will actually look like.
 
 | Guide                                       | Best for                                              | Effort                  |
 | ------------------------------------------- | ----------------------------------------------------- | ----------------------- |
-| [`from-go-router.md`](from-go-router.md)    | Apps using `GoRouter` with string paths               | ~3–4 days, 30 screens   |
-| [`from-auto-route.md`](from-auto-route.md)  | Apps using `@AutoRouterConfig` with `build_runner`    | ~2 days, 30 screens     |
-| [`from-navigator.md`](from-navigator.md)    | Apps on Flutter's `Navigator` — imperative `push`, named routes, or the Router/Pages API (2.0) | ~2–4 days, 30 screens (less from named/2.0) |
+| [From go_router](from-go-router.md)    | Apps using `GoRouter` with string paths               | ~3–4 days, 30 screens   |
+| [From auto_route](from-auto-route.md)  | Apps using `@AutoRouterConfig` with `build_runner`    | ~2 days, 30 screens     |
+| [From Navigator](from-navigator.md)    | Apps on Flutter's `Navigator` — imperative `push`, named routes, or the Router/Pages API (2.0) | ~2–4 days, 30 screens (less from named/2.0) |
 
 ## Which guide is for you
 

assets/brand/kaisel-mark-light.svg

@@ -4,6 +4,7 @@ version: 1.0.0
 repository: https://github.com/Mastersam07/kaisel
 homepage: https://github.com/Mastersam07/kaisel
 issue_tracker: https://github.com/Mastersam07/kaisel/issues
+documentation: https://kaisel.dev
 topics:
   - router
   - navigation

packages/kaisel/doc/migration/README.md

@@ -4,6 +4,7 @@ version: 1.0.0
 repository: https://github.com/Mastersam07/kaisel/tree/dev/packages/kaisel_core
 homepage: https://github.com/Mastersam07/kaisel/tree/dev/packages/kaisel_core
 issue_tracker: https://github.com/Mastersam07/kaisel/issues
+documentation: https://kaisel.dev
 resolution: workspace
 topics:
   - router

packages/kaisel/pubspec.yaml

@@ -4,6 +4,7 @@ version: 0.5.1
 repository: https://github.com/Mastersam07/kaisel/tree/dev/packages/kaisel_lint
 homepage: https://github.com/Mastersam07/kaisel/tree/dev/packages/kaisel_lint
 issue_tracker: https://github.com/Mastersam07/kaisel/issues
+documentation: https://kaisel.dev/tooling/lints/
 
 screenshots:
   - description: The kaisel mark

packages/kaisel_core/pubspec.yaml

@@ -0,0 +1,29 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# generated by scripts/sync-docs.mjs — canonical sources live in
+# skills/kaisel/, packages/kaisel/doc/migration/, and ROADMAP.md
+src/content/docs/guides/
+src/content/docs/migration/
+src/content/docs/roadmap.md
+src/content/docs/tooling/devtools.md
+src/content/docs/tooling/lints.md

packages/kaisel_lint/pubspec.yaml

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

site/.gitignore

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}