diff --git a/docs/web/dist/apple-touch-icon.png b/docs/web/dist/apple-touch-icon.png new file mode 100644 index 0000000..8fc895e Binary files /dev/null and b/docs/web/dist/apple-touch-icon.png differ diff --git a/docs/web/dist/assets/index-BUMrIfxi.css b/docs/web/dist/assets/index-BUMrIfxi.css deleted file mode 100644 index 3788710..0000000 --- a/docs/web/dist/assets/index-BUMrIfxi.css +++ /dev/null @@ -1 +0,0 @@ -@import "https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap";:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--ui-bg:#f3ede3;--ui-surface:#fffaf2;--ui-surface-2:#f7f0e6;--ui-text:#332820;--ui-text-soft:#5e4d3f;--ui-muted:#756455;--ui-border:#e2d5c5;--ui-border-strong:#d3c2ad;--ui-accent:#8a5b3d;--ui-accent-strong:#7a4f33;--ui-accent-soft:#efe0cf;--ui-accent-contrast:#fffaf2;--ui-badge-ok-bg:#e4ecd9;--ui-badge-ok-fg:#55683f;--ui-badge-warn-bg:#fbf0d2;--ui-badge-warn-fg:#7a5c17;--ui-badge-err-bg:#f9e2db;--ui-badge-err-fg:#8a4a38;--ui-badge-info-bg:#efe6ec;--ui-badge-info-fg:#6e4a63;--ui-note:#f4ead9;--ui-tip:#edf0e2;--ui-caution:#fbf0d2;--ui-danger:#f9e2db;--ui-code:#2d231c;--ui-code-text:#f8f1e8;--ui-code-bar:#efe2d2;--ui-code-bar-text:#5e3c27;--ui-shadow-color:#4a34261a;--ui-shadow-strong:#4a342629;--ui-radius-sm:6px;--ui-radius:10px;--ui-radius-lg:16px;--font-display:"DM Sans", ui-sans-serif, system-ui, sans-serif;--sl-font:"DM Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;--sl-font-mono:"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}*{scrollbar-color:var(--ui-border-strong) var(--ui-bg);box-sizing:border-box}html{scroll-behavior:smooth}body{background:var(--ui-bg);color:var(--ui-text);font-family:var(--sl-font);text-rendering:optimizelegibility;-webkit-font-smoothing:antialiased;font-size:1rem;font-weight:400;line-height:1.75}::selection{background:var(--ui-accent-soft);color:var(--ui-accent-strong)}::-webkit-scrollbar{width:12px;height:12px}::-webkit-scrollbar-track{background:var(--ui-bg)}::-webkit-scrollbar-thumb{background:var(--ui-border-strong);border:3px solid var(--ui-bg);border-radius:999px}::-webkit-scrollbar-thumb:hover{background:var(--ui-accent)}:focus-visible{outline:2px solid var(--ui-accent);outline-offset:3px}.skip{z-index:99;background:var(--ui-accent);color:var(--ui-accent-contrast);border-radius:var(--ui-radius-sm);font-family:var(--sl-font);padding:8px 16px;font-weight:600;position:absolute;top:0;left:-9999px}.skip:focus{left:8px}.topbar{background:var(--ui-surface);border-bottom:1px solid var(--ui-border);align-items:center;gap:16px;padding:.6rem clamp(1rem,3vw,2rem);display:flex}.brand{color:var(--ui-text);align-items:center;gap:10px;text-decoration:none;display:inline-flex}.brand-mark{border-radius:var(--ui-radius);background:var(--ui-accent-soft);width:2.25rem;height:2.25rem;color:var(--ui-accent-strong);box-shadow:0 2px 8px var(--ui-shadow-color);font-family:var(--font-display);place-items:center;font-size:.95rem;font-weight:700;display:grid}.brand-name{font-family:var(--font-display);letter-spacing:-.015em;font-size:1rem;font-weight:700}.brand-sub{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.08em;border-radius:999px;padding:.16rem .45rem;font-size:.58rem;font-weight:700}.gh-pill{border:1px solid var(--ui-border);background:var(--ui-surface-2);height:2.25rem;box-shadow:none;color:var(--ui-text-soft);font-family:var(--sl-font);border-radius:8px;align-items:center;gap:.4rem;margin-left:auto;padding:0 1rem;font-size:.8rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s;display:inline-flex}.gh-pill:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.shell{grid-template-columns:210px minmax(0,1fr);align-items:start;gap:clamp(1.5rem,3vw,2.5rem);max-width:1200px;margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem);display:grid}.sidebar{padding-block:.25rem;position:sticky;top:1.5rem}.side-home{margin-bottom:.4rem}.side-group+.side-group{margin-top:1.25rem}.group-label{color:var(--ui-muted);letter-spacing:.12em;text-transform:uppercase;margin:0 0 .4rem;padding:0 .6rem;font-size:.66rem;font-weight:700}.sidebar ul{margin:0;padding:0;list-style:none}.sidebar a,.side-link{color:var(--ui-text-soft);text-transform:capitalize;border-radius:7px;padding:.4rem .6rem;font-weight:500;line-height:1.35;text-decoration:none;transition:background .15s,color .15s;display:block}.sidebar a:hover,.side-link:hover{background:var(--ui-surface-2);color:var(--ui-text)}.sidebar a.is-active,.side-link.is-active{background:var(--ui-accent-soft);color:var(--ui-accent-strong);box-shadow:inset 3px 0 0 var(--ui-accent);font-weight:600}main{min-width:0}.page-head{margin-bottom:26px}.kicker{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.12em;text-transform:uppercase;border-radius:999px;margin:0 0 12px;padding:.22rem .7rem;font-size:.66rem;font-weight:700;display:inline-block}.violet{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.blue{background:var(--ui-note);color:var(--ui-text-soft)}.pink,.yellow{background:var(--ui-caution);color:var(--ui-badge-warn-fg)}h1{color:var(--ui-text);box-shadow:none;font-family:var(--font-display);letter-spacing:-.03em;overflow-wrap:anywhere;background:0 0;margin:0 0 14px;padding:0;font-size:clamp(1.9rem,3.8vw,2.6rem);font-weight:700;line-height:1.12;display:block}.lede{background:var(--ui-surface);max-width:46rem;color:var(--ui-text-soft);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin-block:0 8px;padding:1rem 1.25rem;font-size:1.02rem;line-height:1.7;display:block}h2{border-bottom:1px solid var(--ui-border);font-family:var(--font-display);letter-spacing:-.025em;align-items:center;gap:.6rem;margin-block:2.5rem 1rem;padding-bottom:.55rem;font-size:clamp(1.25rem,2.3vw,1.45rem);font-weight:600;display:flex}h2:before{content:"";background:var(--ui-accent);border-radius:999px;flex:none;width:.35rem;height:1.1em}h3{font-family:var(--font-display);margin-block:1.75rem .6rem;font-size:1.08rem;font-weight:600}strong{color:var(--ui-accent-strong);font-weight:600}code:not(.code-block code){background:var(--ui-surface-2);color:var(--ui-accent-strong);border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);font-family:var(--sl-font-mono);-webkit-box-decoration-break:clone;box-decoration-break:clone;padding:.08em .35em;font-size:.88em;font-weight:500}a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong);text-underline-offset:3px;text-decoration-thickness:1px}a:hover{color:var(--ui-accent);-webkit-text-decoration-color:var(--ui-accent);text-decoration-color:var(--ui-accent);background:0 0}.btn:hover,.gh-pill:hover,.sidebar a:hover,.side-link:hover{background-color:inherit}a.btn:hover{color:var(--ui-accent-contrast);background:var(--ui-accent-strong);text-decoration:none}.hero{background:var(--ui-surface);color:var(--ui-text);border:1px solid var(--ui-border);border-radius:var(--ui-radius-lg);box-shadow:0 16px 40px var(--ui-shadow-color);grid-template-columns:minmax(0,1.15fr) minmax(0,.85fr);align-items:center;gap:clamp(1.5rem,4vw,3rem);margin:.5rem 0 2rem;padding:clamp(1.5rem,4vw,3rem);display:grid;position:relative}.hero-cta{flex-wrap:wrap;gap:.75rem;margin-top:6px;display:flex}.btn{border:1px solid var(--ui-accent);background:var(--ui-accent);color:var(--ui-accent-contrast);box-shadow:0 2px 6px var(--ui-shadow-color);border-radius:9px;padding:.6rem 1.1rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s,box-shadow .15s,transform .15s;display:inline-block}.btn:hover{box-shadow:0 6px 16px var(--ui-shadow-strong);transform:translateY(-1px)}.btn-pink{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.btn-pink:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.btn-yellow{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.cards{grid-template-columns:repeat(auto-fit,minmax(230px,1fr));gap:1.25rem;display:grid}.card{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 1px 2px var(--ui-shadow-color);color:inherit;padding:1.5rem;text-decoration:none;transition:transform .18s,box-shadow .18s,border-color .18s}.card h3{margin-top:0;font-size:.98rem}.card p,.card li{color:var(--ui-muted);font-size:.9rem;line-height:1.6}.card:hover{border-color:var(--ui-border-strong);box-shadow:0 10px 24px var(--ui-shadow-color);transform:translateY(-2px)}a.card h3{color:var(--ui-accent-strong)}.core .card:hover{border-color:var(--ui-accent)}.shot{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);max-width:100%;margin:22px 0;padding:10px}.shot img{border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);width:100%;height:auto;display:block}.shot figcaption{color:var(--ui-muted);margin-top:10px;font-size:.85rem;font-weight:500}.shot a:hover{color:inherit;background:0 0}.shot-feature{max-width:880px}.screen-strip{grid-template-columns:repeat(auto-fit,minmax(300px,1fr));align-items:start;gap:22px;display:grid}.screen-strip .shot{margin:0 0 12px}.code-block{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-code);color:var(--ui-code-text);box-shadow:0 10px 30px var(--ui-shadow-color);margin:20px 0;position:relative;overflow:hidden}.code-label{background:var(--ui-code-bar);color:var(--ui-code-bar-text);font-family:var(--sl-font-mono);letter-spacing:.06em;text-transform:uppercase;padding:.45rem .9rem;font-size:.7rem;font-weight:600;position:absolute;top:0;left:0;right:0}.code-block pre{font-family:var(--sl-font-mono);margin:0;padding:2.2rem 18px 16px;font-size:.86rem;line-height:1.6;overflow-x:auto}.code-block code{color:inherit;font-size:inherit;background:0 0;border:0;padding:0}.table-wrap{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-surface);box-shadow:0 1px 2px var(--ui-shadow-color);margin:18px 0;overflow:auto}table{border-collapse:collapse;width:100%;font-size:.92rem}th,td{text-align:left;vertical-align:top;padding:.65rem .75rem}th{background:var(--ui-surface-2);color:var(--ui-muted);letter-spacing:.06em;text-transform:uppercase;font-size:.7rem;font-weight:700}td{border-top:1px solid var(--ui-border)}tbody tr:nth-child(2n) td{background:var(--ui-surface-2)}td code{white-space:nowrap}.num{font-weight:700}.badge{font-family:var(--sl-font-mono);letter-spacing:.01em;border:0;border-radius:999px;padding:.05rem .5rem;font-size:.74rem;font-weight:600;display:inline-block;transform:none}.badge-ok{background:var(--ui-badge-ok-bg);color:var(--ui-badge-ok-fg)}.badge-warn{background:var(--ui-badge-warn-bg);color:var(--ui-badge-warn-fg)}.badge-err{background:var(--ui-badge-err-bg);color:var(--ui-badge-err-fg)}.badge-info{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.kbd{border:1px solid var(--ui-border);background:var(--ui-surface-2);color:var(--ui-text);box-shadow:none;font-family:var(--sl-font-mono);border-radius:5px;padding:.1em .4em;font-size:.84rem;display:inline-block}.callout{background:var(--ui-note);color:var(--ui-text);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin:20px 0;padding:1rem 1.25rem;font-weight:500}.callout p{margin:0}.callout-info,.callout-ok{background:var(--ui-tip)}ul,ol{padding-inline-start:1.5rem}li::marker{color:var(--ui-accent)}.step-list{counter-reset:steps;padding-left:0;list-style:none}.step-list li{counter-increment:steps;margin-top:14px;padding-left:48px;position:relative}.step-list li:before{content:counter(steps);background:var(--ui-accent-soft);width:30px;height:30px;color:var(--ui-accent-strong);box-shadow:none;font-family:var(--font-display);border-radius:999px;place-items:center;font-weight:600;display:grid;position:absolute;top:0;left:0}.flag-name{font-family:var(--sl-font-mono);font-weight:600}.footer{max-width:1200px;color:var(--ui-muted);margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem) 2.5rem;font-size:.9rem}.footer a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong)}.footer a:hover{background:var(--ui-accent-soft)}.footer-links{margin-top:6px}.file-tree{font-family:var(--sl-font-mono);white-space:pre;font-size:.9rem;overflow-x:auto}@media (width<=900px){.shell{grid-template-columns:1fr}.sidebar{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);flex-wrap:wrap;align-items:center;gap:.4rem;padding:.75rem 1rem;display:flex;position:static}.side-group{display:contents;margin:0!important}.sidebar ul{flex-wrap:wrap;gap:.25rem;display:flex}.group-label{margin:0 .2rem}.sidebar a,.side-link{background:var(--ui-surface-2);border-radius:999px;padding:.3rem .7rem}.sidebar a.is-active,.side-link.is-active{box-shadow:none}}@media (width<=720px){.hero{border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);grid-template-columns:1fr;padding:1.5rem}.shot,.code-block{box-shadow:0 4px 16px var(--ui-shadow-color)}th,td{padding:.5rem .55rem}}@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,:before,:after{transition-duration:.001ms!important;animation-duration:.001ms!important;animation-iteration-count:1!important}} diff --git a/docs/web/dist/assets/index-DZzeKXFv.css b/docs/web/dist/assets/index-DZzeKXFv.css new file mode 100644 index 0000000..005c0fb --- /dev/null +++ b/docs/web/dist/assets/index-DZzeKXFv.css @@ -0,0 +1 @@ +@import "https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap";:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--ui-bg:#f3ede3;--ui-surface:#fffaf2;--ui-surface-2:#f7f0e6;--ui-text:#332820;--ui-text-soft:#5e4d3f;--ui-muted:#756455;--ui-border:#e2d5c5;--ui-border-strong:#d3c2ad;--ui-accent:#8a5b3d;--ui-accent-strong:#7a4f33;--ui-accent-soft:#efe0cf;--ui-accent-contrast:#fffaf2;--ui-badge-ok-bg:#e4ecd9;--ui-badge-ok-fg:#55683f;--ui-badge-warn-bg:#fbf0d2;--ui-badge-warn-fg:#7a5c17;--ui-badge-err-bg:#f9e2db;--ui-badge-err-fg:#8a4a38;--ui-badge-info-bg:#efe6ec;--ui-badge-info-fg:#6e4a63;--ui-note:#f4ead9;--ui-tip:#edf0e2;--ui-caution:#fbf0d2;--ui-danger:#f9e2db;--ui-code:#2d231c;--ui-code-text:#f8f1e8;--ui-code-bar:#efe2d2;--ui-code-bar-text:#5e3c27;--ui-shadow-color:#4a34261a;--ui-shadow-strong:#4a342629;--ui-radius-sm:6px;--ui-radius:10px;--ui-radius-lg:16px;--font-display:"DM Sans", ui-sans-serif, system-ui, sans-serif;--sl-font:"DM Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;--sl-font-mono:"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}*{scrollbar-color:var(--ui-border-strong) var(--ui-bg);box-sizing:border-box}html{scroll-behavior:smooth}body{background:var(--ui-bg);color:var(--ui-text);font-family:var(--sl-font);text-rendering:optimizelegibility;-webkit-font-smoothing:antialiased;font-size:1rem;font-weight:400;line-height:1.75}::selection{background:var(--ui-accent-soft);color:var(--ui-accent-strong)}::-webkit-scrollbar{width:12px;height:12px}::-webkit-scrollbar-track{background:var(--ui-bg)}::-webkit-scrollbar-thumb{background:var(--ui-border-strong);border:3px solid var(--ui-bg);border-radius:999px}::-webkit-scrollbar-thumb:hover{background:var(--ui-accent)}:focus-visible{outline:2px solid var(--ui-accent);outline-offset:3px}.skip{z-index:99;background:var(--ui-accent);color:var(--ui-accent-contrast);border-radius:var(--ui-radius-sm);font-family:var(--sl-font);padding:8px 16px;font-weight:600;position:absolute;top:0;left:-9999px}.skip:focus{left:8px}.topbar{background:var(--ui-surface);border-bottom:1px solid var(--ui-border);align-items:center;gap:16px;padding:.6rem clamp(1rem,3vw,2rem);display:flex}.brand{color:var(--ui-text);align-items:center;gap:10px;text-decoration:none;display:inline-flex}.brand-mark{width:2.25rem;height:2.25rem;box-shadow:0 2px 8px var(--ui-shadow-color);display:block}.brand-name{font-family:var(--font-display);letter-spacing:-.015em;font-size:1rem;font-weight:700}.brand-sub{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.08em;border-radius:999px;padding:.16rem .45rem;font-size:.58rem;font-weight:700}.gh-pill{border:1px solid var(--ui-border);background:var(--ui-surface-2);height:2.25rem;box-shadow:none;color:var(--ui-text-soft);font-family:var(--sl-font);border-radius:8px;align-items:center;gap:.4rem;margin-left:auto;padding:0 1rem;font-size:.8rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s;display:inline-flex}.gh-pill:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.shell{grid-template-columns:210px minmax(0,1fr);align-items:start;gap:clamp(1.5rem,3vw,2.5rem);max-width:1200px;margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem);display:grid}.sidebar{padding-block:.25rem;position:sticky;top:1.5rem}.side-home{margin-bottom:.4rem}.side-group+.side-group{margin-top:1.25rem}.group-label{color:var(--ui-muted);letter-spacing:.12em;text-transform:uppercase;margin:0 0 .4rem;padding:0 .6rem;font-size:.66rem;font-weight:700}.sidebar ul{margin:0;padding:0;list-style:none}.sidebar a,.side-link{color:var(--ui-text-soft);text-transform:capitalize;border-radius:7px;padding:.4rem .6rem;font-weight:500;line-height:1.35;text-decoration:none;transition:background .15s,color .15s;display:block}.sidebar a:hover,.side-link:hover{background:var(--ui-surface-2);color:var(--ui-text)}.sidebar a.is-active,.side-link.is-active{background:var(--ui-accent-soft);color:var(--ui-accent-strong);box-shadow:inset 3px 0 0 var(--ui-accent);font-weight:600}main{min-width:0}.page-head{margin-bottom:26px}.kicker{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.12em;text-transform:uppercase;border-radius:999px;margin:0 0 12px;padding:.22rem .7rem;font-size:.66rem;font-weight:700;display:inline-block}.violet{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.blue{background:var(--ui-note);color:var(--ui-text-soft)}.pink,.yellow{background:var(--ui-caution);color:var(--ui-badge-warn-fg)}h1{color:var(--ui-text);box-shadow:none;font-family:var(--font-display);letter-spacing:-.03em;overflow-wrap:anywhere;background:0 0;margin:0 0 14px;padding:0;font-size:clamp(1.9rem,3.8vw,2.6rem);font-weight:700;line-height:1.12;display:block}.lede{background:var(--ui-surface);max-width:46rem;color:var(--ui-text-soft);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin-block:0 8px;padding:1rem 1.25rem;font-size:1.02rem;line-height:1.7;display:block}h2{border-bottom:1px solid var(--ui-border);font-family:var(--font-display);letter-spacing:-.025em;align-items:center;gap:.6rem;margin-block:2.5rem 1rem;padding-bottom:.55rem;font-size:clamp(1.25rem,2.3vw,1.45rem);font-weight:600;display:flex}h2:before{content:"";background:var(--ui-accent);border-radius:999px;flex:none;width:.35rem;height:1.1em}h3{font-family:var(--font-display);margin-block:1.75rem .6rem;font-size:1.08rem;font-weight:600}strong{color:var(--ui-accent-strong);font-weight:600}code:not(.code-block code){background:var(--ui-surface-2);color:var(--ui-accent-strong);border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);font-family:var(--sl-font-mono);-webkit-box-decoration-break:clone;box-decoration-break:clone;padding:.08em .35em;font-size:.88em;font-weight:500}a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong);text-underline-offset:3px;text-decoration-thickness:1px}a:hover{color:var(--ui-accent);-webkit-text-decoration-color:var(--ui-accent);text-decoration-color:var(--ui-accent);background:0 0}.btn:hover,.gh-pill:hover,.sidebar a:hover,.side-link:hover{background-color:inherit}a.btn:hover{color:var(--ui-accent-contrast);background:var(--ui-accent-strong);text-decoration:none}.hero{background:var(--ui-surface);color:var(--ui-text);border:1px solid var(--ui-border);border-radius:var(--ui-radius-lg);box-shadow:0 16px 40px var(--ui-shadow-color);grid-template-columns:minmax(0,1.15fr) minmax(0,.85fr);align-items:center;gap:clamp(1.5rem,4vw,3rem);margin:.5rem 0 2rem;padding:clamp(1.5rem,4vw,3rem);display:grid;position:relative}.hero-cta{flex-wrap:wrap;gap:.75rem;margin-top:6px;display:flex}.btn{border:1px solid var(--ui-accent);background:var(--ui-accent);color:var(--ui-accent-contrast);box-shadow:0 2px 6px var(--ui-shadow-color);border-radius:9px;padding:.6rem 1.1rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s,box-shadow .15s,transform .15s;display:inline-block}.btn:hover{box-shadow:0 6px 16px var(--ui-shadow-strong);transform:translateY(-1px)}.btn-pink{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.btn-pink:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.btn-yellow{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.cards{grid-template-columns:repeat(auto-fit,minmax(230px,1fr));gap:1.25rem;display:grid}.card{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 1px 2px var(--ui-shadow-color);color:inherit;padding:1.5rem;text-decoration:none;transition:transform .18s,box-shadow .18s,border-color .18s}.card h3{margin-top:0;font-size:.98rem}.card p,.card li{color:var(--ui-muted);font-size:.9rem;line-height:1.6}.card:hover{border-color:var(--ui-border-strong);box-shadow:0 10px 24px var(--ui-shadow-color);transform:translateY(-2px)}a.card h3{color:var(--ui-accent-strong)}.core .card:hover{border-color:var(--ui-accent)}.shot{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);max-width:100%;margin:22px 0;padding:10px}.shot img{border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);width:100%;height:auto;display:block}.shot figcaption{color:var(--ui-muted);margin-top:10px;font-size:.85rem;font-weight:500}.shot a:hover{color:inherit;background:0 0}.shot-feature{max-width:880px}.screen-strip{grid-template-columns:repeat(auto-fit,minmax(300px,1fr));align-items:start;gap:22px;display:grid}.screen-strip .shot{margin:0 0 12px}.code-block{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-code);color:var(--ui-code-text);box-shadow:0 10px 30px var(--ui-shadow-color);margin:20px 0;position:relative;overflow:hidden}.code-label{background:var(--ui-code-bar);color:var(--ui-code-bar-text);font-family:var(--sl-font-mono);letter-spacing:.06em;text-transform:uppercase;padding:.45rem .9rem;font-size:.7rem;font-weight:600;position:absolute;top:0;left:0;right:0}.code-block pre{font-family:var(--sl-font-mono);margin:0;padding:2.2rem 18px 16px;font-size:.86rem;line-height:1.6;overflow-x:auto}.code-block code{color:inherit;font-size:inherit;background:0 0;border:0;padding:0}.table-wrap{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-surface);box-shadow:0 1px 2px var(--ui-shadow-color);margin:18px 0;overflow:auto}table{border-collapse:collapse;width:100%;font-size:.92rem}th,td{text-align:left;vertical-align:top;padding:.65rem .75rem}th{background:var(--ui-surface-2);color:var(--ui-muted);letter-spacing:.06em;text-transform:uppercase;font-size:.7rem;font-weight:700}td{border-top:1px solid var(--ui-border)}tbody tr:nth-child(2n) td{background:var(--ui-surface-2)}td code{white-space:nowrap}.num{font-weight:700}.badge{font-family:var(--sl-font-mono);letter-spacing:.01em;border:0;border-radius:999px;padding:.05rem .5rem;font-size:.74rem;font-weight:600;display:inline-block;transform:none}.badge-ok{background:var(--ui-badge-ok-bg);color:var(--ui-badge-ok-fg)}.badge-warn{background:var(--ui-badge-warn-bg);color:var(--ui-badge-warn-fg)}.badge-err{background:var(--ui-badge-err-bg);color:var(--ui-badge-err-fg)}.badge-info{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.kbd{border:1px solid var(--ui-border);background:var(--ui-surface-2);color:var(--ui-text);box-shadow:none;font-family:var(--sl-font-mono);border-radius:5px;padding:.1em .4em;font-size:.84rem;display:inline-block}.callout{background:var(--ui-note);color:var(--ui-text);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin:20px 0;padding:1rem 1.25rem;font-weight:500}.callout p{margin:0}.callout-info,.callout-ok{background:var(--ui-tip)}ul,ol{padding-inline-start:1.5rem}li::marker{color:var(--ui-accent)}.step-list{counter-reset:steps;padding-left:0;list-style:none}.step-list li{counter-increment:steps;margin-top:14px;padding-left:48px;position:relative}.step-list li:before{content:counter(steps);background:var(--ui-accent-soft);width:30px;height:30px;color:var(--ui-accent-strong);box-shadow:none;font-family:var(--font-display);border-radius:999px;place-items:center;font-weight:600;display:grid;position:absolute;top:0;left:0}.flag-name{font-family:var(--sl-font-mono);font-weight:600}.footer{max-width:1200px;color:var(--ui-muted);margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem) 2.5rem;font-size:.9rem}.footer a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong)}.footer a:hover{background:var(--ui-accent-soft)}.footer-links{margin-top:6px}.file-tree{font-family:var(--sl-font-mono);white-space:pre;font-size:.9rem;overflow-x:auto}@media (width<=900px){.shell{grid-template-columns:1fr}.sidebar{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);flex-wrap:wrap;align-items:center;gap:.4rem;padding:.75rem 1rem;display:flex;position:static}.side-group{display:contents;margin:0!important}.sidebar ul{flex-wrap:wrap;gap:.25rem;display:flex}.group-label{margin:0 .2rem}.sidebar a,.side-link{background:var(--ui-surface-2);border-radius:999px;padding:.3rem .7rem}.sidebar a.is-active,.side-link.is-active{box-shadow:none}}@media (width<=720px){.hero{border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);grid-template-columns:1fr;padding:1.5rem}.shot,.code-block{box-shadow:0 4px 16px var(--ui-shadow-color)}th,td{padding:.5rem .55rem}}@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,:before,:after{transition-duration:.001ms!important;animation-duration:.001ms!important;animation-iteration-count:1!important}} diff --git a/docs/web/dist/assets/index-Bpn6tfSv.js b/docs/web/dist/assets/index-y37U0USe.js similarity index 98% rename from docs/web/dist/assets/index-Bpn6tfSv.js rename to docs/web/dist/assets/index-y37U0USe.js index 6aa11c9..f4f0aa8 100644 --- a/docs/web/dist/assets/index-Bpn6tfSv.js +++ b/docs/web/dist/assets/index-y37U0USe.js @@ -22,4 +22,4 @@ case $? in 3) devopsgen init --force --stack go --registry ghcr --image you/myapp --port 8080 ;; 2) echo "fix your flags" >&2 ;; *) echo "see devopsgen validate output" >&2 ;; -esac`}),(0,d.jsx)(`div`,{className:`callout callout-info`,children:`Codes are part of DevOpsGen's compatibility promise: bumping a major version may add new codes, but existing ones keep their meaning.`})]})}var re=`https://devopsgen.bangkah.tech/`,x=[{path:``,component:_,title:`DevOpsGen — DevOps scaffolding for Go & Node.js projects`,description:`DevOpsGen generates production-ready Dockerfiles, GitHub Actions pipelines and Kubernetes manifests for Go and Node.js projects, with safe dry-run plans, automatic backups and config validation.`,keywords:`DevOpsGen, dockerfile generator, github actions generator, kubernetes manifests, go, nodejs, scaffolding, ci cd`,ogImage:`img/init-success.png`},{path:`getting-started`,component:v,title:`Getting Started — DevOpsGen Docs`,description:`Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.`,keywords:`DevOpsGen install, go install, quickstart, getting started`,ogImage:`img/init-success.png`},{path:`wizard`,component:y,title:`Interactive Wizard — DevOpsGen Docs`,description:`DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.`,keywords:`DevOpsGen wizard, tui, bubbletea, interactive`,ogImage:`img/wizard.png`},{path:`init`,component:b,title:`init command — DevOpsGen Docs`,description:`Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.`,keywords:`devopsgen init, flags, dry-run, force, image, ingress`,ogImage:`img/init-success.png`},{path:`detect`,component:ee,title:`detect command — DevOpsGen Docs`,description:`devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.`,keywords:`devopsgen detect, stack detection, go.mod, package.json`,ogImage:`img/detect.png`},{path:`validate`,component:te,title:`validate command — DevOpsGen Docs`,description:`devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.`,keywords:`devopsgen validate, dockerfile lint, workflow lint, kubernetes manifest lint`,ogImage:`img/validate.png`},{path:`exit-codes`,component:ne,title:`Exit codes — DevOpsGen Docs`,description:`Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.`,keywords:`devopsgen exit codes, ci integration, pipeline status`,ogImage:`img/validate.png`}],ie=[{label:`Overview`,items:[`getting-started`,`wizard`]},{label:`Command reference`,items:[`init`,`detect`,`validate`]},{label:`Operations`,items:[`exit-codes`]}];function S({rel:e,activePath:t,children:n}){return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(`a`,{className:`skip`,href:`#main`,children:`skip to content`}),(0,d.jsxs)(`header`,{className:`topbar`,children:[(0,d.jsxs)(`a`,{className:`brand`,href:e||`./`,children:[(0,d.jsx)(`span`,{className:`brand-mark`,children:`DG`}),(0,d.jsx)(`span`,{className:`brand-name`,children:`DevOpsGen`}),(0,d.jsx)(`span`,{className:`brand-sub`,children:`DOCS`})]}),(0,d.jsx)(`a`,{className:`gh-pill`,href:`https://github.com/Bangkahdev/DevOpsGen`,rel:`noopener noreferrer`,target:`_blank`,children:`GitHub`})]}),(0,d.jsxs)(`div`,{className:`shell`,children:[(0,d.jsxs)(`aside`,{className:`sidebar`,"aria-label":`Documentation navigation`,children:[(0,d.jsx)(`a`,{className:`side-link side-home${t===``?` is-active`:``}`,href:e||`./`,children:`Home`}),ie.map(n=>(0,d.jsxs)(`div`,{className:`side-group`,children:[(0,d.jsx)(`p`,{className:`group-label`,children:n.label}),(0,d.jsx)(`ul`,{children:n.items.map(n=>{let r=x.find(e=>e.path===n);return(0,d.jsx)(`li`,{children:(0,d.jsx)(`a`,{className:`side-link${t===n?` is-active`:``}`,href:`${e}${n}/`,"aria-current":t===n?`page`:void 0,children:r?r.path.replace(/-/g,` `):n})},n)})})]},n.label))]}),(0,d.jsx)(`main`,{id:`main`,children:n})]}),(0,d.jsxs)(`footer`,{className:`footer`,children:[(0,d.jsxs)(`p`,{children:[`DevOpsGen — deterministic DevOps scaffolding for Go & Node.js.`,` `,(0,d.jsx)(`a`,{href:`${e}getting-started/`,children:`Get started`}),` or browse the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]}),(0,d.jsxs)(`p`,{className:`footer-links`,children:[(0,d.jsx)(`a`,{href:re,children:`canonical site`}),` · `,(0,d.jsx)(`a`,{href:`https://github.com/Bangkahdev/DevOpsGen`,children:`source code`})]})]})]})}var ae=x.find(e=>e.path===location.pathname.replace(/\/$/,``).replace(/^.*\//,``))??null,oe=ae&&ae.path===``?``:`../`,se=ae??x[0];(0,l.createRoot)(document.getElementById(`root`)).render((0,d.jsx)(S,{rel:oe,activePath:ae?ae.path:``,children:(0,d.jsx)(se.component,{rel:oe})})); \ No newline at end of file +esac`}),(0,d.jsx)(`div`,{className:`callout callout-info`,children:`Codes are part of DevOpsGen's compatibility promise: bumping a major version may add new codes, but existing ones keep their meaning.`})]})}var re=`https://devopsgen.bangkah.tech/`,x=[{path:``,component:_,title:`DevOpsGen — DevOps scaffolding for Go & Node.js projects`,description:`DevOpsGen generates production-ready Dockerfiles, GitHub Actions pipelines and Kubernetes manifests for Go and Node.js projects, with safe dry-run plans, automatic backups and config validation.`,keywords:`DevOpsGen, dockerfile generator, github actions generator, kubernetes manifests, go, nodejs, scaffolding, ci cd`,ogImage:`img/og.png`},{path:`getting-started`,component:v,title:`Getting Started — DevOpsGen Docs`,description:`Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.`,keywords:`DevOpsGen install, go install, quickstart, getting started`,ogImage:`img/init-success.png`},{path:`wizard`,component:y,title:`Interactive Wizard — DevOpsGen Docs`,description:`DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.`,keywords:`DevOpsGen wizard, tui, bubbletea, interactive`,ogImage:`img/wizard.png`},{path:`init`,component:b,title:`init command — DevOpsGen Docs`,description:`Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.`,keywords:`devopsgen init, flags, dry-run, force, image, ingress`,ogImage:`img/init-success.png`},{path:`detect`,component:ee,title:`detect command — DevOpsGen Docs`,description:`devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.`,keywords:`devopsgen detect, stack detection, go.mod, package.json`,ogImage:`img/detect.png`},{path:`validate`,component:te,title:`validate command — DevOpsGen Docs`,description:`devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.`,keywords:`devopsgen validate, dockerfile lint, workflow lint, kubernetes manifest lint`,ogImage:`img/validate.png`},{path:`exit-codes`,component:ne,title:`Exit codes — DevOpsGen Docs`,description:`Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.`,keywords:`devopsgen exit codes, ci integration, pipeline status`,ogImage:`img/validate.png`}],ie=[{label:`Overview`,items:[`getting-started`,`wizard`]},{label:`Command reference`,items:[`init`,`detect`,`validate`]},{label:`Operations`,items:[`exit-codes`]}];function S({rel:e,activePath:t,children:n}){let r=t===``;return(0,d.jsxs)(d.Fragment,{children:[(0,d.jsx)(`a`,{className:`skip`,href:`#main`,children:`skip to content`}),(0,d.jsxs)(`header`,{className:`topbar`,children:[(0,d.jsxs)(`a`,{className:`brand`,href:e||`./`,children:[(0,d.jsx)(`img`,{className:`brand-mark`,src:`${e}logo.svg`,width:`36`,height:`36`,alt:``}),(0,d.jsx)(`span`,{className:`brand-name`,children:`DevOpsGen`}),(0,d.jsx)(`span`,{className:`brand-sub`,children:`DOCS`})]}),(0,d.jsx)(`a`,{className:`gh-pill`,href:`https://github.com/Bangkahdev/DevOpsGen`,rel:`noopener noreferrer`,target:`_blank`,children:`GitHub`})]}),(0,d.jsxs)(`div`,{className:`shell`,children:[(0,d.jsxs)(`aside`,{className:`sidebar`,"aria-label":`Documentation navigation`,children:[(0,d.jsx)(`a`,{className:`side-link side-home${r?` is-active`:``}`,href:e||`./`,children:`Home`}),ie.map(n=>(0,d.jsxs)(`div`,{className:`side-group`,children:[(0,d.jsx)(`p`,{className:`group-label`,children:n.label}),(0,d.jsx)(`ul`,{children:n.items.map(n=>{let r=x.find(e=>e.path===n);return(0,d.jsx)(`li`,{children:(0,d.jsx)(`a`,{className:`side-link${t===n?` is-active`:``}`,href:`${e}${n}/`,"aria-current":t===n?`page`:void 0,children:r?r.path.replace(/-/g,` `):n})},n)})})]},n.label))]}),(0,d.jsx)(`main`,{id:`main`,children:n})]}),(0,d.jsxs)(`footer`,{className:`footer`,children:[(0,d.jsxs)(`p`,{children:[`DevOpsGen — deterministic DevOps scaffolding for Go & Node.js.`,` `,(0,d.jsx)(`a`,{href:`${e}getting-started/`,children:`Get started`}),` or browse the`,` `,(0,d.jsx)(`a`,{href:`${e}exit-codes/`,children:`exit codes`}),`.`]}),(0,d.jsxs)(`p`,{className:`footer-links`,children:[(0,d.jsx)(`a`,{href:re,children:`canonical site`}),` · `,(0,d.jsx)(`a`,{href:`https://github.com/Bangkahdev/DevOpsGen`,children:`source code`})]})]})]})}var ae=x.find(e=>e.path===location.pathname.replace(/\/$/,``).replace(/^.*\//,``))??null,oe=ae&&ae.path===``?``:`../`,se=ae??x[0];(0,l.createRoot)(document.getElementById(`root`)).render((0,d.jsx)(S,{rel:oe,activePath:ae?ae.path:``,children:(0,d.jsx)(se.component,{rel:oe})})); \ No newline at end of file diff --git a/docs/web/dist/assets/site.css b/docs/web/dist/assets/site.css index 3788710..005c0fb 100644 --- a/docs/web/dist/assets/site.css +++ b/docs/web/dist/assets/site.css @@ -1 +1 @@ -@import "https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap";:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--ui-bg:#f3ede3;--ui-surface:#fffaf2;--ui-surface-2:#f7f0e6;--ui-text:#332820;--ui-text-soft:#5e4d3f;--ui-muted:#756455;--ui-border:#e2d5c5;--ui-border-strong:#d3c2ad;--ui-accent:#8a5b3d;--ui-accent-strong:#7a4f33;--ui-accent-soft:#efe0cf;--ui-accent-contrast:#fffaf2;--ui-badge-ok-bg:#e4ecd9;--ui-badge-ok-fg:#55683f;--ui-badge-warn-bg:#fbf0d2;--ui-badge-warn-fg:#7a5c17;--ui-badge-err-bg:#f9e2db;--ui-badge-err-fg:#8a4a38;--ui-badge-info-bg:#efe6ec;--ui-badge-info-fg:#6e4a63;--ui-note:#f4ead9;--ui-tip:#edf0e2;--ui-caution:#fbf0d2;--ui-danger:#f9e2db;--ui-code:#2d231c;--ui-code-text:#f8f1e8;--ui-code-bar:#efe2d2;--ui-code-bar-text:#5e3c27;--ui-shadow-color:#4a34261a;--ui-shadow-strong:#4a342629;--ui-radius-sm:6px;--ui-radius:10px;--ui-radius-lg:16px;--font-display:"DM Sans", ui-sans-serif, system-ui, sans-serif;--sl-font:"DM Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;--sl-font-mono:"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}*{scrollbar-color:var(--ui-border-strong) var(--ui-bg);box-sizing:border-box}html{scroll-behavior:smooth}body{background:var(--ui-bg);color:var(--ui-text);font-family:var(--sl-font);text-rendering:optimizelegibility;-webkit-font-smoothing:antialiased;font-size:1rem;font-weight:400;line-height:1.75}::selection{background:var(--ui-accent-soft);color:var(--ui-accent-strong)}::-webkit-scrollbar{width:12px;height:12px}::-webkit-scrollbar-track{background:var(--ui-bg)}::-webkit-scrollbar-thumb{background:var(--ui-border-strong);border:3px solid var(--ui-bg);border-radius:999px}::-webkit-scrollbar-thumb:hover{background:var(--ui-accent)}:focus-visible{outline:2px solid var(--ui-accent);outline-offset:3px}.skip{z-index:99;background:var(--ui-accent);color:var(--ui-accent-contrast);border-radius:var(--ui-radius-sm);font-family:var(--sl-font);padding:8px 16px;font-weight:600;position:absolute;top:0;left:-9999px}.skip:focus{left:8px}.topbar{background:var(--ui-surface);border-bottom:1px solid var(--ui-border);align-items:center;gap:16px;padding:.6rem clamp(1rem,3vw,2rem);display:flex}.brand{color:var(--ui-text);align-items:center;gap:10px;text-decoration:none;display:inline-flex}.brand-mark{border-radius:var(--ui-radius);background:var(--ui-accent-soft);width:2.25rem;height:2.25rem;color:var(--ui-accent-strong);box-shadow:0 2px 8px var(--ui-shadow-color);font-family:var(--font-display);place-items:center;font-size:.95rem;font-weight:700;display:grid}.brand-name{font-family:var(--font-display);letter-spacing:-.015em;font-size:1rem;font-weight:700}.brand-sub{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.08em;border-radius:999px;padding:.16rem .45rem;font-size:.58rem;font-weight:700}.gh-pill{border:1px solid var(--ui-border);background:var(--ui-surface-2);height:2.25rem;box-shadow:none;color:var(--ui-text-soft);font-family:var(--sl-font);border-radius:8px;align-items:center;gap:.4rem;margin-left:auto;padding:0 1rem;font-size:.8rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s;display:inline-flex}.gh-pill:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.shell{grid-template-columns:210px minmax(0,1fr);align-items:start;gap:clamp(1.5rem,3vw,2.5rem);max-width:1200px;margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem);display:grid}.sidebar{padding-block:.25rem;position:sticky;top:1.5rem}.side-home{margin-bottom:.4rem}.side-group+.side-group{margin-top:1.25rem}.group-label{color:var(--ui-muted);letter-spacing:.12em;text-transform:uppercase;margin:0 0 .4rem;padding:0 .6rem;font-size:.66rem;font-weight:700}.sidebar ul{margin:0;padding:0;list-style:none}.sidebar a,.side-link{color:var(--ui-text-soft);text-transform:capitalize;border-radius:7px;padding:.4rem .6rem;font-weight:500;line-height:1.35;text-decoration:none;transition:background .15s,color .15s;display:block}.sidebar a:hover,.side-link:hover{background:var(--ui-surface-2);color:var(--ui-text)}.sidebar a.is-active,.side-link.is-active{background:var(--ui-accent-soft);color:var(--ui-accent-strong);box-shadow:inset 3px 0 0 var(--ui-accent);font-weight:600}main{min-width:0}.page-head{margin-bottom:26px}.kicker{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.12em;text-transform:uppercase;border-radius:999px;margin:0 0 12px;padding:.22rem .7rem;font-size:.66rem;font-weight:700;display:inline-block}.violet{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.blue{background:var(--ui-note);color:var(--ui-text-soft)}.pink,.yellow{background:var(--ui-caution);color:var(--ui-badge-warn-fg)}h1{color:var(--ui-text);box-shadow:none;font-family:var(--font-display);letter-spacing:-.03em;overflow-wrap:anywhere;background:0 0;margin:0 0 14px;padding:0;font-size:clamp(1.9rem,3.8vw,2.6rem);font-weight:700;line-height:1.12;display:block}.lede{background:var(--ui-surface);max-width:46rem;color:var(--ui-text-soft);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin-block:0 8px;padding:1rem 1.25rem;font-size:1.02rem;line-height:1.7;display:block}h2{border-bottom:1px solid var(--ui-border);font-family:var(--font-display);letter-spacing:-.025em;align-items:center;gap:.6rem;margin-block:2.5rem 1rem;padding-bottom:.55rem;font-size:clamp(1.25rem,2.3vw,1.45rem);font-weight:600;display:flex}h2:before{content:"";background:var(--ui-accent);border-radius:999px;flex:none;width:.35rem;height:1.1em}h3{font-family:var(--font-display);margin-block:1.75rem .6rem;font-size:1.08rem;font-weight:600}strong{color:var(--ui-accent-strong);font-weight:600}code:not(.code-block code){background:var(--ui-surface-2);color:var(--ui-accent-strong);border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);font-family:var(--sl-font-mono);-webkit-box-decoration-break:clone;box-decoration-break:clone;padding:.08em .35em;font-size:.88em;font-weight:500}a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong);text-underline-offset:3px;text-decoration-thickness:1px}a:hover{color:var(--ui-accent);-webkit-text-decoration-color:var(--ui-accent);text-decoration-color:var(--ui-accent);background:0 0}.btn:hover,.gh-pill:hover,.sidebar a:hover,.side-link:hover{background-color:inherit}a.btn:hover{color:var(--ui-accent-contrast);background:var(--ui-accent-strong);text-decoration:none}.hero{background:var(--ui-surface);color:var(--ui-text);border:1px solid var(--ui-border);border-radius:var(--ui-radius-lg);box-shadow:0 16px 40px var(--ui-shadow-color);grid-template-columns:minmax(0,1.15fr) minmax(0,.85fr);align-items:center;gap:clamp(1.5rem,4vw,3rem);margin:.5rem 0 2rem;padding:clamp(1.5rem,4vw,3rem);display:grid;position:relative}.hero-cta{flex-wrap:wrap;gap:.75rem;margin-top:6px;display:flex}.btn{border:1px solid var(--ui-accent);background:var(--ui-accent);color:var(--ui-accent-contrast);box-shadow:0 2px 6px var(--ui-shadow-color);border-radius:9px;padding:.6rem 1.1rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s,box-shadow .15s,transform .15s;display:inline-block}.btn:hover{box-shadow:0 6px 16px var(--ui-shadow-strong);transform:translateY(-1px)}.btn-pink{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.btn-pink:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.btn-yellow{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.cards{grid-template-columns:repeat(auto-fit,minmax(230px,1fr));gap:1.25rem;display:grid}.card{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 1px 2px var(--ui-shadow-color);color:inherit;padding:1.5rem;text-decoration:none;transition:transform .18s,box-shadow .18s,border-color .18s}.card h3{margin-top:0;font-size:.98rem}.card p,.card li{color:var(--ui-muted);font-size:.9rem;line-height:1.6}.card:hover{border-color:var(--ui-border-strong);box-shadow:0 10px 24px var(--ui-shadow-color);transform:translateY(-2px)}a.card h3{color:var(--ui-accent-strong)}.core .card:hover{border-color:var(--ui-accent)}.shot{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);max-width:100%;margin:22px 0;padding:10px}.shot img{border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);width:100%;height:auto;display:block}.shot figcaption{color:var(--ui-muted);margin-top:10px;font-size:.85rem;font-weight:500}.shot a:hover{color:inherit;background:0 0}.shot-feature{max-width:880px}.screen-strip{grid-template-columns:repeat(auto-fit,minmax(300px,1fr));align-items:start;gap:22px;display:grid}.screen-strip .shot{margin:0 0 12px}.code-block{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-code);color:var(--ui-code-text);box-shadow:0 10px 30px var(--ui-shadow-color);margin:20px 0;position:relative;overflow:hidden}.code-label{background:var(--ui-code-bar);color:var(--ui-code-bar-text);font-family:var(--sl-font-mono);letter-spacing:.06em;text-transform:uppercase;padding:.45rem .9rem;font-size:.7rem;font-weight:600;position:absolute;top:0;left:0;right:0}.code-block pre{font-family:var(--sl-font-mono);margin:0;padding:2.2rem 18px 16px;font-size:.86rem;line-height:1.6;overflow-x:auto}.code-block code{color:inherit;font-size:inherit;background:0 0;border:0;padding:0}.table-wrap{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-surface);box-shadow:0 1px 2px var(--ui-shadow-color);margin:18px 0;overflow:auto}table{border-collapse:collapse;width:100%;font-size:.92rem}th,td{text-align:left;vertical-align:top;padding:.65rem .75rem}th{background:var(--ui-surface-2);color:var(--ui-muted);letter-spacing:.06em;text-transform:uppercase;font-size:.7rem;font-weight:700}td{border-top:1px solid var(--ui-border)}tbody tr:nth-child(2n) td{background:var(--ui-surface-2)}td code{white-space:nowrap}.num{font-weight:700}.badge{font-family:var(--sl-font-mono);letter-spacing:.01em;border:0;border-radius:999px;padding:.05rem .5rem;font-size:.74rem;font-weight:600;display:inline-block;transform:none}.badge-ok{background:var(--ui-badge-ok-bg);color:var(--ui-badge-ok-fg)}.badge-warn{background:var(--ui-badge-warn-bg);color:var(--ui-badge-warn-fg)}.badge-err{background:var(--ui-badge-err-bg);color:var(--ui-badge-err-fg)}.badge-info{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.kbd{border:1px solid var(--ui-border);background:var(--ui-surface-2);color:var(--ui-text);box-shadow:none;font-family:var(--sl-font-mono);border-radius:5px;padding:.1em .4em;font-size:.84rem;display:inline-block}.callout{background:var(--ui-note);color:var(--ui-text);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin:20px 0;padding:1rem 1.25rem;font-weight:500}.callout p{margin:0}.callout-info,.callout-ok{background:var(--ui-tip)}ul,ol{padding-inline-start:1.5rem}li::marker{color:var(--ui-accent)}.step-list{counter-reset:steps;padding-left:0;list-style:none}.step-list li{counter-increment:steps;margin-top:14px;padding-left:48px;position:relative}.step-list li:before{content:counter(steps);background:var(--ui-accent-soft);width:30px;height:30px;color:var(--ui-accent-strong);box-shadow:none;font-family:var(--font-display);border-radius:999px;place-items:center;font-weight:600;display:grid;position:absolute;top:0;left:0}.flag-name{font-family:var(--sl-font-mono);font-weight:600}.footer{max-width:1200px;color:var(--ui-muted);margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem) 2.5rem;font-size:.9rem}.footer a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong)}.footer a:hover{background:var(--ui-accent-soft)}.footer-links{margin-top:6px}.file-tree{font-family:var(--sl-font-mono);white-space:pre;font-size:.9rem;overflow-x:auto}@media (width<=900px){.shell{grid-template-columns:1fr}.sidebar{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);flex-wrap:wrap;align-items:center;gap:.4rem;padding:.75rem 1rem;display:flex;position:static}.side-group{display:contents;margin:0!important}.sidebar ul{flex-wrap:wrap;gap:.25rem;display:flex}.group-label{margin:0 .2rem}.sidebar a,.side-link{background:var(--ui-surface-2);border-radius:999px;padding:.3rem .7rem}.sidebar a.is-active,.side-link.is-active{box-shadow:none}}@media (width<=720px){.hero{border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);grid-template-columns:1fr;padding:1.5rem}.shot,.code-block{box-shadow:0 4px 16px var(--ui-shadow-color)}th,td{padding:.5rem .55rem}}@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,:before,:after{transition-duration:.001ms!important;animation-duration:.001ms!important;animation-iteration-count:1!important}} +@import "https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap";:root{--lightningcss-light:initial;--lightningcss-dark: ;color-scheme:light;--ui-bg:#f3ede3;--ui-surface:#fffaf2;--ui-surface-2:#f7f0e6;--ui-text:#332820;--ui-text-soft:#5e4d3f;--ui-muted:#756455;--ui-border:#e2d5c5;--ui-border-strong:#d3c2ad;--ui-accent:#8a5b3d;--ui-accent-strong:#7a4f33;--ui-accent-soft:#efe0cf;--ui-accent-contrast:#fffaf2;--ui-badge-ok-bg:#e4ecd9;--ui-badge-ok-fg:#55683f;--ui-badge-warn-bg:#fbf0d2;--ui-badge-warn-fg:#7a5c17;--ui-badge-err-bg:#f9e2db;--ui-badge-err-fg:#8a4a38;--ui-badge-info-bg:#efe6ec;--ui-badge-info-fg:#6e4a63;--ui-note:#f4ead9;--ui-tip:#edf0e2;--ui-caution:#fbf0d2;--ui-danger:#f9e2db;--ui-code:#2d231c;--ui-code-text:#f8f1e8;--ui-code-bar:#efe2d2;--ui-code-bar-text:#5e3c27;--ui-shadow-color:#4a34261a;--ui-shadow-strong:#4a342629;--ui-radius-sm:6px;--ui-radius:10px;--ui-radius-lg:16px;--font-display:"DM Sans", ui-sans-serif, system-ui, sans-serif;--sl-font:"DM Sans", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;--sl-font-mono:"JetBrains Mono", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace}*{scrollbar-color:var(--ui-border-strong) var(--ui-bg);box-sizing:border-box}html{scroll-behavior:smooth}body{background:var(--ui-bg);color:var(--ui-text);font-family:var(--sl-font);text-rendering:optimizelegibility;-webkit-font-smoothing:antialiased;font-size:1rem;font-weight:400;line-height:1.75}::selection{background:var(--ui-accent-soft);color:var(--ui-accent-strong)}::-webkit-scrollbar{width:12px;height:12px}::-webkit-scrollbar-track{background:var(--ui-bg)}::-webkit-scrollbar-thumb{background:var(--ui-border-strong);border:3px solid var(--ui-bg);border-radius:999px}::-webkit-scrollbar-thumb:hover{background:var(--ui-accent)}:focus-visible{outline:2px solid var(--ui-accent);outline-offset:3px}.skip{z-index:99;background:var(--ui-accent);color:var(--ui-accent-contrast);border-radius:var(--ui-radius-sm);font-family:var(--sl-font);padding:8px 16px;font-weight:600;position:absolute;top:0;left:-9999px}.skip:focus{left:8px}.topbar{background:var(--ui-surface);border-bottom:1px solid var(--ui-border);align-items:center;gap:16px;padding:.6rem clamp(1rem,3vw,2rem);display:flex}.brand{color:var(--ui-text);align-items:center;gap:10px;text-decoration:none;display:inline-flex}.brand-mark{width:2.25rem;height:2.25rem;box-shadow:0 2px 8px var(--ui-shadow-color);display:block}.brand-name{font-family:var(--font-display);letter-spacing:-.015em;font-size:1rem;font-weight:700}.brand-sub{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.08em;border-radius:999px;padding:.16rem .45rem;font-size:.58rem;font-weight:700}.gh-pill{border:1px solid var(--ui-border);background:var(--ui-surface-2);height:2.25rem;box-shadow:none;color:var(--ui-text-soft);font-family:var(--sl-font);border-radius:8px;align-items:center;gap:.4rem;margin-left:auto;padding:0 1rem;font-size:.8rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s;display:inline-flex}.gh-pill:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.shell{grid-template-columns:210px minmax(0,1fr);align-items:start;gap:clamp(1.5rem,3vw,2.5rem);max-width:1200px;margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem);display:grid}.sidebar{padding-block:.25rem;position:sticky;top:1.5rem}.side-home{margin-bottom:.4rem}.side-group+.side-group{margin-top:1.25rem}.group-label{color:var(--ui-muted);letter-spacing:.12em;text-transform:uppercase;margin:0 0 .4rem;padding:0 .6rem;font-size:.66rem;font-weight:700}.sidebar ul{margin:0;padding:0;list-style:none}.sidebar a,.side-link{color:var(--ui-text-soft);text-transform:capitalize;border-radius:7px;padding:.4rem .6rem;font-weight:500;line-height:1.35;text-decoration:none;transition:background .15s,color .15s;display:block}.sidebar a:hover,.side-link:hover{background:var(--ui-surface-2);color:var(--ui-text)}.sidebar a.is-active,.side-link.is-active{background:var(--ui-accent-soft);color:var(--ui-accent-strong);box-shadow:inset 3px 0 0 var(--ui-accent);font-weight:600}main{min-width:0}.page-head{margin-bottom:26px}.kicker{background:var(--ui-accent-soft);color:var(--ui-accent-strong);letter-spacing:.12em;text-transform:uppercase;border-radius:999px;margin:0 0 12px;padding:.22rem .7rem;font-size:.66rem;font-weight:700;display:inline-block}.violet{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.blue{background:var(--ui-note);color:var(--ui-text-soft)}.pink,.yellow{background:var(--ui-caution);color:var(--ui-badge-warn-fg)}h1{color:var(--ui-text);box-shadow:none;font-family:var(--font-display);letter-spacing:-.03em;overflow-wrap:anywhere;background:0 0;margin:0 0 14px;padding:0;font-size:clamp(1.9rem,3.8vw,2.6rem);font-weight:700;line-height:1.12;display:block}.lede{background:var(--ui-surface);max-width:46rem;color:var(--ui-text-soft);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin-block:0 8px;padding:1rem 1.25rem;font-size:1.02rem;line-height:1.7;display:block}h2{border-bottom:1px solid var(--ui-border);font-family:var(--font-display);letter-spacing:-.025em;align-items:center;gap:.6rem;margin-block:2.5rem 1rem;padding-bottom:.55rem;font-size:clamp(1.25rem,2.3vw,1.45rem);font-weight:600;display:flex}h2:before{content:"";background:var(--ui-accent);border-radius:999px;flex:none;width:.35rem;height:1.1em}h3{font-family:var(--font-display);margin-block:1.75rem .6rem;font-size:1.08rem;font-weight:600}strong{color:var(--ui-accent-strong);font-weight:600}code:not(.code-block code){background:var(--ui-surface-2);color:var(--ui-accent-strong);border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);font-family:var(--sl-font-mono);-webkit-box-decoration-break:clone;box-decoration-break:clone;padding:.08em .35em;font-size:.88em;font-weight:500}a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong);text-underline-offset:3px;text-decoration-thickness:1px}a:hover{color:var(--ui-accent);-webkit-text-decoration-color:var(--ui-accent);text-decoration-color:var(--ui-accent);background:0 0}.btn:hover,.gh-pill:hover,.sidebar a:hover,.side-link:hover{background-color:inherit}a.btn:hover{color:var(--ui-accent-contrast);background:var(--ui-accent-strong);text-decoration:none}.hero{background:var(--ui-surface);color:var(--ui-text);border:1px solid var(--ui-border);border-radius:var(--ui-radius-lg);box-shadow:0 16px 40px var(--ui-shadow-color);grid-template-columns:minmax(0,1.15fr) minmax(0,.85fr);align-items:center;gap:clamp(1.5rem,4vw,3rem);margin:.5rem 0 2rem;padding:clamp(1.5rem,4vw,3rem);display:grid;position:relative}.hero-cta{flex-wrap:wrap;gap:.75rem;margin-top:6px;display:flex}.btn{border:1px solid var(--ui-accent);background:var(--ui-accent);color:var(--ui-accent-contrast);box-shadow:0 2px 6px var(--ui-shadow-color);border-radius:9px;padding:.6rem 1.1rem;font-weight:600;text-decoration:none;transition:background .15s,border-color .15s,box-shadow .15s,transform .15s;display:inline-block}.btn:hover{box-shadow:0 6px 16px var(--ui-shadow-strong);transform:translateY(-1px)}.btn-pink{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.btn-pink:hover{background:var(--ui-accent-soft);border-color:var(--ui-border-strong);color:var(--ui-accent-strong)}.btn-yellow{background:var(--ui-surface-2);color:var(--ui-text);border-color:var(--ui-border)}.cards{grid-template-columns:repeat(auto-fit,minmax(230px,1fr));gap:1.25rem;display:grid}.card{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 1px 2px var(--ui-shadow-color);color:inherit;padding:1.5rem;text-decoration:none;transition:transform .18s,box-shadow .18s,border-color .18s}.card h3{margin-top:0;font-size:.98rem}.card p,.card li{color:var(--ui-muted);font-size:.9rem;line-height:1.6}.card:hover{border-color:var(--ui-border-strong);box-shadow:0 10px 24px var(--ui-shadow-color);transform:translateY(-2px)}a.card h3{color:var(--ui-accent-strong)}.core .card:hover{border-color:var(--ui-accent)}.shot{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);max-width:100%;margin:22px 0;padding:10px}.shot img{border:1px solid var(--ui-border);border-radius:var(--ui-radius-sm);width:100%;height:auto;display:block}.shot figcaption{color:var(--ui-muted);margin-top:10px;font-size:.85rem;font-weight:500}.shot a:hover{color:inherit;background:0 0}.shot-feature{max-width:880px}.screen-strip{grid-template-columns:repeat(auto-fit,minmax(300px,1fr));align-items:start;gap:22px;display:grid}.screen-strip .shot{margin:0 0 12px}.code-block{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-code);color:var(--ui-code-text);box-shadow:0 10px 30px var(--ui-shadow-color);margin:20px 0;position:relative;overflow:hidden}.code-label{background:var(--ui-code-bar);color:var(--ui-code-bar-text);font-family:var(--sl-font-mono);letter-spacing:.06em;text-transform:uppercase;padding:.45rem .9rem;font-size:.7rem;font-weight:600;position:absolute;top:0;left:0;right:0}.code-block pre{font-family:var(--sl-font-mono);margin:0;padding:2.2rem 18px 16px;font-size:.86rem;line-height:1.6;overflow-x:auto}.code-block code{color:inherit;font-size:inherit;background:0 0;border:0;padding:0}.table-wrap{border:1px solid var(--ui-border);border-radius:var(--ui-radius);background:var(--ui-surface);box-shadow:0 1px 2px var(--ui-shadow-color);margin:18px 0;overflow:auto}table{border-collapse:collapse;width:100%;font-size:.92rem}th,td{text-align:left;vertical-align:top;padding:.65rem .75rem}th{background:var(--ui-surface-2);color:var(--ui-muted);letter-spacing:.06em;text-transform:uppercase;font-size:.7rem;font-weight:700}td{border-top:1px solid var(--ui-border)}tbody tr:nth-child(2n) td{background:var(--ui-surface-2)}td code{white-space:nowrap}.num{font-weight:700}.badge{font-family:var(--sl-font-mono);letter-spacing:.01em;border:0;border-radius:999px;padding:.05rem .5rem;font-size:.74rem;font-weight:600;display:inline-block;transform:none}.badge-ok{background:var(--ui-badge-ok-bg);color:var(--ui-badge-ok-fg)}.badge-warn{background:var(--ui-badge-warn-bg);color:var(--ui-badge-warn-fg)}.badge-err{background:var(--ui-badge-err-bg);color:var(--ui-badge-err-fg)}.badge-info{background:var(--ui-badge-info-bg);color:var(--ui-badge-info-fg)}.kbd{border:1px solid var(--ui-border);background:var(--ui-surface-2);color:var(--ui-text);box-shadow:none;font-family:var(--sl-font-mono);border-radius:5px;padding:.1em .4em;font-size:.84rem;display:inline-block}.callout{background:var(--ui-note);color:var(--ui-text);border:1px solid var(--ui-border);border-inline-start:3px solid var(--ui-accent);border-radius:8px;margin:20px 0;padding:1rem 1.25rem;font-weight:500}.callout p{margin:0}.callout-info,.callout-ok{background:var(--ui-tip)}ul,ol{padding-inline-start:1.5rem}li::marker{color:var(--ui-accent)}.step-list{counter-reset:steps;padding-left:0;list-style:none}.step-list li{counter-increment:steps;margin-top:14px;padding-left:48px;position:relative}.step-list li:before{content:counter(steps);background:var(--ui-accent-soft);width:30px;height:30px;color:var(--ui-accent-strong);box-shadow:none;font-family:var(--font-display);border-radius:999px;place-items:center;font-weight:600;display:grid;position:absolute;top:0;left:0}.flag-name{font-family:var(--sl-font-mono);font-weight:600}.footer{max-width:1200px;color:var(--ui-muted);margin:0 auto;padding:1.5rem clamp(1rem,3vw,2rem) 2.5rem;font-size:.9rem}.footer a{color:var(--ui-accent-strong);text-decoration:underline;-webkit-text-decoration-color:var(--ui-border-strong);text-decoration-color:var(--ui-border-strong)}.footer a:hover{background:var(--ui-accent-soft)}.footer-links{margin-top:6px}.file-tree{font-family:var(--sl-font-mono);white-space:pre;font-size:.9rem;overflow-x:auto}@media (width<=900px){.shell{grid-template-columns:1fr}.sidebar{background:var(--ui-surface);border:1px solid var(--ui-border);border-radius:var(--ui-radius);flex-wrap:wrap;align-items:center;gap:.4rem;padding:.75rem 1rem;display:flex;position:static}.side-group{display:contents;margin:0!important}.sidebar ul{flex-wrap:wrap;gap:.25rem;display:flex}.group-label{margin:0 .2rem}.sidebar a,.side-link{background:var(--ui-surface-2);border-radius:999px;padding:.3rem .7rem}.sidebar a.is-active,.side-link.is-active{box-shadow:none}}@media (width<=720px){.hero{border-radius:var(--ui-radius);box-shadow:0 8px 24px var(--ui-shadow-color);grid-template-columns:1fr;padding:1.5rem}.shot,.code-block{box-shadow:0 4px 16px var(--ui-shadow-color)}th,td{padding:.5rem .55rem}}@media (prefers-reduced-motion:reduce){html{scroll-behavior:auto}*,:before,:after{transition-duration:.001ms!important;animation-duration:.001ms!important;animation-iteration-count:1!important}} diff --git a/docs/web/dist/detect/index.html b/docs/web/dist/detect/index.html index a1718c7..db0bdd8 100644 --- a/docs/web/dist/detect/index.html +++ b/docs/web/dist/detect/index.html @@ -6,21 +6,29 @@ detect command — DevOpsGen Docs + + + + + + + + - + -
DGDevOpsGenDOCSGitHub

command reference

devopsgen detect

Inspect the current project and report what DevOpsGen would scaffold for it: the programming stack, the exact files that shaped the decision, and the candidate application types.

devopsgen detect output in a terminal reporting stack go with indicators go.mod
devopsgen detect inside a Go module — chain of evidence straight from the filesystem.

Reading the output

LineMeaning
stack: goThe detected programming stack (go or nodejs).
indicators: go.mod, ...The files that produced evidence — your audit trail for why the stack matched.
app-type candidates: binaryApplication types plausible for this project; the wizard default comes from here too.

How it decides

Detection semantics: DevOpsGen detects in the current working directory, not in --output-dir. Run it from the project you want scanned.
+
DevOpsGenDOCSGitHub

command reference

devopsgen detect

Inspect the current project and report what DevOpsGen would scaffold for it: the programming stack, the exact files that shaped the decision, and the candidate application types.

devopsgen detect output in a terminal reporting stack go with indicators go.mod
devopsgen detect inside a Go module — chain of evidence straight from the filesystem.

Reading the output

LineMeaning
stack: goThe detected programming stack (go or nodejs).
indicators: go.mod, ...The files that produced evidence — your audit trail for why the stack matched.
app-type candidates: binaryApplication types plausible for this project; the wizard default comes from here too.

How it decides

Detection semantics: DevOpsGen detects in the current working directory, not in --output-dir. Run it from the project you want scanned.
\ No newline at end of file diff --git a/docs/web/dist/exit-codes/index.html b/docs/web/dist/exit-codes/index.html index 60ced99..544b905 100644 --- a/docs/web/dist/exit-codes/index.html +++ b/docs/web/dist/exit-codes/index.html @@ -6,22 +6,30 @@ Exit codes — DevOpsGen Docs + + + + + + + + - + -
DGDevOpsGenDOCSGitHub

ci integration

Exit codes

Every DevOpsGen command exits with a stable, documented status code so shells, scripts and CI jobs can branch deterministically — no output parsing required.

CodeClassificationMeaningTypical example
0successEverything requested completed; dry-run plans that resolved cleanly also end here.init created 5 files; --dry-run --force plan is green.
1general errorUnexpected failure — I/O errors, template issues, or a run that failed mid-write and rolled back.Disk full while writing deployment.yaml.
2invalid inputConfiguration failed validation before anything was planned or written.--image BANGKAH/my-app; port -1; Ingress without host.
3conflictTarget files already exist and would be overwritten; nothing was written. Retried with --force.Second init without --force.
4validation failedRejected output: a template rendering failure, required artifacts missing, or generated documents failing the static lint rules.A workflow that never publishes the commit SHA tag.
5detectionStack detection was ambiguous or found nothing at all.Empty directory without go.mod / package.json.

In practice

devopsgen validate reporting internal validation passed with exit code 0
Exit 0 — internal validation passed.
shell script branching
devopsgen init --stack go --registry ghcr --image you/myapp --port 8080
+
DevOpsGenDOCSGitHub
ci integration
Exit codes
Every DevOpsGen command exits with a stable, documented status code so shells, scripts and CI jobs can branch deterministically — no output parsing required.
CodeClassificationMeaningTypical example
0successEverything requested completed; dry-run plans that resolved cleanly also end here.init created 5 files; --dry-run --force plan is green.
1general errorUnexpected failure — I/O errors, template issues, or a run that failed mid-write and rolled back.Disk full while writing deployment.yaml.
2invalid inputConfiguration failed validation before anything was planned or written.--image BANGKAH/my-app; port -1; Ingress without host.
3conflictTarget files already exist and would be overwritten; nothing was written. Retried with --force.Second init without --force.
4validation failedRejected output: a template rendering failure, required artifacts missing, or generated documents failing the static lint rules.A workflow that never publishes the commit SHA tag.
5detectionStack detection was ambiguous or found nothing at all.Empty directory without go.mod / package.json.
In practice
devopsgen validate reporting internal validation passed with exit code 0
Exit 0 — internal validation passed.
shell script branching
devopsgen init --stack go --registry ghcr --image you/myapp --port 8080
 case $? in
   0) echo "ready" ;;
   3) devopsgen init --force --stack go --registry ghcr --image you/myapp --port 8080 ;;
diff --git a/docs/web/dist/favicon.svg b/docs/web/dist/favicon.svg
new file mode 100644
index 0000000..07a976b
--- /dev/null
+++ b/docs/web/dist/favicon.svg
@@ -0,0 +1,5 @@
+
+  
+  
+  
+
diff --git a/docs/web/dist/getting-started/index.html b/docs/web/dist/getting-started/index.html
index 7dfdaf0..af03a74 100644
--- a/docs/web/dist/getting-started/index.html
+++ b/docs/web/dist/getting-started/index.html
@@ -6,22 +6,30 @@
   Getting Started — DevOpsGen Docs
   
   
+  
+  
+  
+  
+  
   
   
   
+  
   
   
   
   
+  
   
   
   
   
+  
   
-  
+  
 
 
-
DGDevOpsGenDOCSGitHub
getting started
Zero to CI in one command
Install DevOpsGen, point it at any Go or Node.js project, and get a full Docker + GitHub Actions + Kubernetes baseline in seconds.
Install
go install (go 1.22+)
go install devopsgen.dev/devopsgen@latest
Or grab a prebuilt binary from the project GitHub releases, or build from source:
from source
git clone https://github.com/Bangkahdev/DevOpsGen.git
+
DevOpsGenDOCSGitHub
getting started
Zero to CI in one command
Install DevOpsGen, point it at any Go or Node.js project, and get a full Docker + GitHub Actions + Kubernetes baseline in seconds.
Install
go install (go 1.22+)
go install devopsgen.dev/devopsgen@latest
Or grab a prebuilt binary from the project GitHub releases, or build from source:
from source
git clone https://github.com/Bangkahdev/DevOpsGen.git
 cd DevOpsGen
 make build
Two ways to run it
  • Interactive: run devopsgen init in a terminal — the wizard detects your stack and interviews you step by step.
  • Headless: pass every required parameter as flags — the process never waits for stdin, which makes it script- and CI-friendly.
Headless quickstart
inside your project
devopsgen init   --stack go   --ci github-actions   --registry ghcr   --image you/myapp   --port 8080
Terminal capture of devopsgen init completing successfully and reporting five files created
A successful first run — five files created, exit code 0.
Inside a Go project this writes:
what you get
.github/workflows/ci.yml   # tests (when configured), docker build & push
 kubernetes/deployment.yaml  # image, port, resources, optional probes
diff --git a/docs/web/dist/img/og.png b/docs/web/dist/img/og.png
new file mode 100644
index 0000000..bcdb7b0
Binary files /dev/null and b/docs/web/dist/img/og.png differ
diff --git a/docs/web/dist/index.html b/docs/web/dist/index.html
index 6e3067d..ea5886e 100644
--- a/docs/web/dist/index.html
+++ b/docs/web/dist/index.html
@@ -6,22 +6,32 @@
   DevOpsGen — DevOps scaffolding for Go & Node.js projects
   
   
+  
+  
+  
+  
+  
   
   
   
+  
   
   
   
-  
+  
+  
+  
+  
   
   
   
-  
+  
+  
   
-  
+  
 
 
-
DGDevOpsGenDOCSGitHub
docker · github actions · kubernetes
DevOps scaffolding,
deterministically.
DevOpsGen reads your Go or Node.js project and writes a complete, opinionated DevOps baseline: hardened Dockerfile, GitHub Actions pipeline and ready-to-apply Kubernetes manifests — with dry-run plans, automatic backups and config validation built in.
Get startedTake the wizard tour
DevOpsGen interactive wizard running in a Windows terminal, asking for the project stack
The interactive wizard — press Enter to accept smart defaults.
Why DevOpsGen
Deterministic
Same inputs, same bytes — every run. Machine-friendly for code review: a second generation with --force produces bit-identical files.
Safe by default
Existing files are never overwritten without --force. Overwrites get .bak backups, failed runs roll back automatically, and --dry-run prints the full plan first.
Validated output
Built-in validation checks Dockerfile structure, GitHub Actions workflow wiring and Kubernetes manifests (selector consistency, port ranges, Ingress paths) before anything ships.
Stack aware
Detects Go and Node.js projects (npm, pnpm, Express, Next.js, Vite, NestJS) from go.mod / package.json and tailors templates accordingly.
Everything a project needs on day one
One init command writes the whole baseline tree. Preview the real terminal output of every command below — all screenshots are live captures, not mockups.
generated in one command
$ devopsgen init --stack go --ci github-actions --registry ghcr --image you/myapp --port 8080
+
DevOpsGenDOCSGitHub
docker · github actions · kubernetes
DevOps scaffolding,
deterministically.
DevOpsGen reads your Go or Node.js project and writes a complete, opinionated DevOps baseline: hardened Dockerfile, GitHub Actions pipeline and ready-to-apply Kubernetes manifests — with dry-run plans, automatic backups and config validation built in.
Get startedTake the wizard tour
DevOpsGen interactive wizard running in a Windows terminal, asking for the project stack
The interactive wizard — press Enter to accept smart defaults.
Why DevOpsGen
Deterministic
Same inputs, same bytes — every run. Machine-friendly for code review: a second generation with --force produces bit-identical files.
Safe by default
Existing files are never overwritten without --force. Overwrites get .bak backups, failed runs roll back automatically, and --dry-run prints the full plan first.
Validated output
Built-in validation checks Dockerfile structure, GitHub Actions workflow wiring and Kubernetes manifests (selector consistency, port ranges, Ingress paths) before anything ships.
Stack aware
Detects Go and Node.js projects (npm, pnpm, Express, Next.js, Vite, NestJS) from go.mod / package.json and tailors templates accordingly.
Everything a project needs on day one
One init command writes the whole baseline tree. Preview the real terminal output of every command below — all screenshots are live captures, not mockups.
generated in one command
$ devopsgen init --stack go --ci github-actions --registry ghcr --image you/myapp --port 8080
 created 5 file(s), replaced 0 file(s) in .
 exit code: 0
Terminal showing a successful DevOpsGen init run creating five files with exit code 0
init — first run creates the complete baseline and exits 0.
Terminal showing a DevOpsGen dry-run plan listing five create entries with exit code 0
--dry-run on a fresh project prints the pure create plan and exits 0.
Terminal showing a DevOpsGen dry-run force plan where every file would be replaced, exit code 0
--dry-run --force previews the full replace plan — still nothing written.
What gets generated
Template setFilesPurpose
docker (+ .dockerignore)DockerfileHardened multi-stage build (Go runs as USER 1000:1000 on a scratch base). For Node.js, RUN steps and install/prune commands follow the detected package manager (npm / pnpm) and lockfile. The generated .dockerignore keeps state, tool caches and env files out of the image.
github-actions.github/workflows/ci.ymlRuns your tests when a test command is configured, then builds and pushes the image with both the commit SHA tag and your alias tag, authenticating to the chosen registry via secrets.
kubernetesdeployment.yaml, service.yaml, optional ingress.yamlDNS 1035-safe resource names, container port wiring, resource requests and limits, health probes when --health-path is given, and an optional host-based Ingress (RFC 1123 hostname).
Explore the docs
getting started
Install DevOpsGen via go install or a release binary, then generate a complete Docker, CI and Kubernetes setup for your project with a single command.
wizard
DevOpsGen launches an interactive TUI wizard that walks through stack detection, ports, container images and Kubernetes options, then writes the generated configuration.
init
Full reference for devopsgen init flags: stack, app type, CI provider, registry, image, port, Kubernetes ingress, health path, dry-run and force overwrite behaviour.
detect
devopsgen detect inspects the current project and reports the programming stack, the files it based its decision on, and candidate application types.
validate
devopsgen validate statically checks generated Dockerfiles, GitHub Actions workflows and Kubernetes manifests: FROM digests, action pinning, naming rules, probes and more.
exit codes
Every devopsgen command exits with a documented status code: 0 success, 1 general error, 2 invalid configuration, 3 file conflicts, 4 validation failure, 5 ambiguous detection.
Command cheatsheet
Terminal showing the full devopsgen help output listing all commands
devopsgen --help — all commands at a glance.
Terminal showing the devopsgen list output with available stacks, app types and registries
devopsgen list — supported stacks, app types and registries.
Terminal showing the devopsgen version output
devopsgen version.

 
diff --git a/docs/web/dist/init/index.html b/docs/web/dist/init/index.html
index 2e1a428..12f2753 100644
--- a/docs/web/dist/init/index.html
+++ b/docs/web/dist/init/index.html
@@ -6,21 +6,29 @@
   init command — DevOpsGen Docs
   
   
+  
+  
+  
+  
+  
   
   
   
+  
   
   
   
   
+  
   
   
   
   
+  
   
-  
+  
 
 
-
DGDevOpsGenDOCSGitHub
command reference
devopsgen init
Initialize DevOps configuration. In an interactive terminal with no complete configuration the TUI wizard is launched; when all required parameters are supplied via flags the process runs headless and never waits for stdin.
synopsis
devopsgen init [flags]
Flags
FlagDefaultDescription
--stackauto-detectedProject stack: go or nodejs.
--app-typeauto-detectedApplication type (see devopsgen list).
--cigithub-actionsCI provider.
--registrydockerhubContainer registry: dockerhub or ghcr.
--image—Image repository as namespace/repository — no host and no tag.
--taglatestAdditional image tag alias.
--port—Application port, 1–65535.
--k8strueGenerate Kubernetes manifests.
--ingressoffEnable Kubernetes Ingress (requires --ingress-host).
--ingress-host—Ingress hostname, validated as RFC 1123.
--health-path—HTTP health probe path wired into manifests.
--build-cmd—Build command.
--build-path.Go package path to build inside the container.
--start-cmd—Startup command.
--test-cmd—Test command.
--output-dir.Output directory.
--dry-runoffSimulate without writing anything.
--forceoffOverwrite existing regular files.
Success & conflict behaviour
A clean run writes every template and exits with 0. A second run over an existing project stops before touching anything and exits with 3 until you add --force; a detailed walkthrough of that re-run path is on the exit codes page.
devopsgen init success output with exit code 0
First run: five files created, exit code 0.
Preview plans with --dry-run
--dry-run prints the byte-plan and writes nothing. On a fresh project it lists pure create rows and exits 0; combined with --force over an existing project it lists the exact files that would be replaced — still 0:
devopsgen dry-run plan output showing five create entries with exit code 0
--dry-run on a fresh project: pure create plan, exit code 0.
devopsgen dry-run force plan output where every file would be replaced, exit code 0
--dry-run --force: every file replaced in plan form, exit code 0.
Config validation
Invalid configuration fails fast with 2 before any file is planned and never writes files — e.g. an image that must be namespace/repository without host or tag, a port outside 1–65535, or an Ingress without a host. The full code table lives on the exit codes page.
Overwrites performed with --force keep the previous content as <file>.devopsgen.bak backups, and any failure mid-run triggers a best-effort rollback to the pre-run state.

+
DevOpsGenDOCSGitHub
command reference
devopsgen init
Initialize DevOps configuration. In an interactive terminal with no complete configuration the TUI wizard is launched; when all required parameters are supplied via flags the process runs headless and never waits for stdin.
synopsis
devopsgen init [flags]
Flags
FlagDefaultDescription
--stackauto-detectedProject stack: go or nodejs.
--app-typeauto-detectedApplication type (see devopsgen list).
--cigithub-actionsCI provider.
--registrydockerhubContainer registry: dockerhub or ghcr.
--image—Image repository as namespace/repository — no host and no tag.
--taglatestAdditional image tag alias.
--port—Application port, 1–65535.
--k8strueGenerate Kubernetes manifests.
--ingressoffEnable Kubernetes Ingress (requires --ingress-host).
--ingress-host—Ingress hostname, validated as RFC 1123.
--health-path—HTTP health probe path wired into manifests.
--build-cmd—Build command.
--build-path.Go package path to build inside the container.
--start-cmd—Startup command.
--test-cmd—Test command.
--output-dir.Output directory.
--dry-runoffSimulate without writing anything.
--forceoffOverwrite existing regular files.
Success & conflict behaviour
A clean run writes every template and exits with 0. A second run over an existing project stops before touching anything and exits with 3 until you add --force; a detailed walkthrough of that re-run path is on the exit codes page.
devopsgen init success output with exit code 0
First run: five files created, exit code 0.
Preview plans with --dry-run
--dry-run prints the byte-plan and writes nothing. On a fresh project it lists pure create rows and exits 0; combined with --force over an existing project it lists the exact files that would be replaced — still 0:
devopsgen dry-run plan output showing five create entries with exit code 0
--dry-run on a fresh project: pure create plan, exit code 0.
devopsgen dry-run force plan output where every file would be replaced, exit code 0
--dry-run --force: every file replaced in plan form, exit code 0.
Config validation
Invalid configuration fails fast with 2 before any file is planned and never writes files — e.g. an image that must be namespace/repository without host or tag, a port outside 1–65535, or an Ingress without a host. The full code table lives on the exit codes page.
Overwrites performed with --force keep the previous content as <file>.devopsgen.bak backups, and any failure mid-run triggers a best-effort rollback to the pre-run state.

 
 
\ No newline at end of file
diff --git a/docs/web/dist/logo.svg b/docs/web/dist/logo.svg
new file mode 100644
index 0000000..3e42dd3
--- /dev/null
+++ b/docs/web/dist/logo.svg
@@ -0,0 +1,5 @@
+
+  
+  
+  
+
diff --git a/docs/web/dist/validate/index.html b/docs/web/dist/validate/index.html
index 4ce6d68..24b7201 100644
--- a/docs/web/dist/validate/index.html
+++ b/docs/web/dist/validate/index.html
@@ -6,22 +6,30 @@
   validate command — DevOpsGen Docs
   
   
+  
+  
+  
+  
+  
   
   
   
+  
   
   
   
   
+  
   
   
   
   
+  
   
-  
+  
 
 
-
DGDevOpsGenDOCSGitHub
command reference
devopsgen validate
Statically lint DevOpsGen output — Dockerfiles, GitHub Actions workflows and Kubernetes manifests — so problems surface on your laptop instead of pipeline number forty.
devopsgen validate passing with the message internal validation passed and exit code 0
Everything checks out — exit code 0.
synopsis
devopsgen validate [flags]          # validate the current project
+
DevOpsGenDOCSGitHub
command reference
devopsgen validate
Statically lint DevOpsGen output — Dockerfiles, GitHub Actions workflows and Kubernetes manifests — so problems surface on your laptop instead of pipeline number forty.
devopsgen validate passing with the message internal validation passed and exit code 0
Everything checks out — exit code 0.
synopsis
devopsgen validate [flags]          # validate the current project
 devopsgen validate --output-dir ./configs
What it checks
Docker
  • FROM instruction is present
  • no docker login (credentials) inside image builds
  • COPY/ADD free of shell chaining (&&, ||, 2>/dev/null)
GitHub Actions
  • parses as a single workflow document with name, on, jobs and steps
  • a actions/checkout step exists
  • the image push references the commit SHA tag
  • no unrendered template actions leak into the output
Kubernetes
  • Deployment: selector ↔ template label consistency, unique container names, integer containerPort in 1–65535
  • Service: selector plus port/targetPort pairs
  • Ingress: networking.k8s.io/v1, valid pathType, wired backend.service
  • Service ↔ Ingress backends stay consistent
Exit behaviour
  • 0 — all documents passed.
  • 4 — a document failed lint rules, does not parse, or required artifacts are missing.
  • 1 — the output directory itself could not be read.
  • 2 — malformed input (invalid flags).
Combine with devopsgen init in CI: generate, commit, validate, deploy — the exit codes page maps every failure class.
Combine with devopsgen init in CI: generate, commit, validate, deploy — the exit codes page maps every failure class.

 
 
\ No newline at end of file
diff --git a/docs/web/dist/wizard/index.html b/docs/web/dist/wizard/index.html
index e3f1709..bfbfcd8 100644
--- a/docs/web/dist/wizard/index.html
+++ b/docs/web/dist/wizard/index.html
@@ -6,21 +6,29 @@
   Interactive Wizard — DevOpsGen Docs
   
   
+  
+  
+  
+  
+  
   
   
   
+  
   
   
   
   
+  
   
   
   
   
+  
   
-  
+  
 
 
-
DGDevOpsGenDOCSGitHub
interactive wizard
The TUI wizard
When you run devopsgen init in a real terminal without a flags-only invocation, a keyboard-driven wizard takes over — Enter accepts the recommended default at every step.
DevOpsGen wizard TUI showing the stack selection list with a highlighted highlighted selection and instructions
Step 1 — stack choice. DevOpsGen pre-selects what its detector recommends.
How the interview flows
  • Stack — go or nodejs, pre-selected by the detector.
  • Application type (Node.js only) — express, nextjs, vite, nestjs or generic.
  • Commands — optional build / test / start commands; Enter keeps the defaults harvested from the project files.
  • Port — the application port, 1–65535, validated on the spot.
  • Registry — Docker Hub or GHCR (same as the --registry flag).
  • Container image — namespace/repository, no host, no tag.
  • Kubernetes — whether to emit manifests, plus an optional host-based Ingress (RFC 1123 hostname).
  • Summary & confirm — review every chosen value, confirm, and the files are written to the project root.
A wizard run is fully replayable: the same answers as equivalent flags. To automate the same result, pass the flags headless (init reference).
Keyboard
KeyAction
EnterConfirm current selection / printed default
↑ ↓Move within list choices
typed textFill textual answers (port, image, host)
Ctrl+CAbort the wizard without writing anything
Safety during the run
Everything until the final confirmation is bound to memory only — aborting leaves the project untouched. The write itself follows the same rules as headless mode: never-overwrite-unless---force, backups, and rollback on mid-run failure.

+
DevOpsGenDOCSGitHub
interactive wizard
The TUI wizard
When you run devopsgen init in a real terminal without a flags-only invocation, a keyboard-driven wizard takes over — Enter accepts the recommended default at every step.
DevOpsGen wizard TUI showing the stack selection list with a highlighted highlighted selection and instructions
Step 1 — stack choice. DevOpsGen pre-selects what its detector recommends.
How the interview flows
  • Stack — go or nodejs, pre-selected by the detector.
  • Application type (Node.js only) — express, nextjs, vite, nestjs or generic.
  • Commands — optional build / test / start commands; Enter keeps the defaults harvested from the project files.
  • Port — the application port, 1–65535, validated on the spot.
  • Registry — Docker Hub or GHCR (same as the --registry flag).
  • Container image — namespace/repository, no host, no tag.
  • Kubernetes — whether to emit manifests, plus an optional host-based Ingress (RFC 1123 hostname).
  • Summary & confirm — review every chosen value, confirm, and the files are written to the project root.
A wizard run is fully replayable: the same answers as equivalent flags. To automate the same result, pass the flags headless (init reference).
Keyboard
KeyAction
EnterConfirm current selection / printed default
↑ ↓Move within list choices
typed textFill textual answers (port, image, host)
Ctrl+CAbort the wizard without writing anything
Safety during the run
Everything until the final confirmation is bound to memory only — aborting leaves the project untouched. The write itself follows the same rules as headless mode: never-overwrite-unless---force, backups, and rollback on mid-run failure.

 
 
\ No newline at end of file
diff --git a/docs/web/public/apple-touch-icon.png b/docs/web/public/apple-touch-icon.png
new file mode 100644
index 0000000..8fc895e
Binary files /dev/null and b/docs/web/public/apple-touch-icon.png differ
diff --git a/docs/web/public/favicon.svg b/docs/web/public/favicon.svg
new file mode 100644
index 0000000..07a976b
--- /dev/null
+++ b/docs/web/public/favicon.svg
@@ -0,0 +1,5 @@
+
+  
+  
+  
+
diff --git a/docs/web/public/img/og.png b/docs/web/public/img/og.png
new file mode 100644
index 0000000..bcdb7b0
Binary files /dev/null and b/docs/web/public/img/og.png differ
diff --git a/docs/web/public/logo.svg b/docs/web/public/logo.svg
new file mode 100644
index 0000000..3e42dd3
--- /dev/null
+++ b/docs/web/public/logo.svg
@@ -0,0 +1,5 @@
+
+  
+  
+  
+
diff --git a/docs/web/src/components/Layout.jsx b/docs/web/src/components/Layout.jsx
index e5884ff..6a3febd 100644
--- a/docs/web/src/components/Layout.jsx
+++ b/docs/web/src/components/Layout.jsx
@@ -13,7 +13,7 @@ export default function Layout({ rel, activePath, children }) {
       skip to content
       

         
-          DG
+          
           DevOpsGen
           DOCS
         
diff --git a/docs/web/src/entry-server.jsx b/docs/web/src/entry-server.jsx
index 3a74502..83535f8 100644
--- a/docs/web/src/entry-server.jsx
+++ b/docs/web/src/entry-server.jsx
@@ -43,13 +43,25 @@ export function renderDocument(route) {
         applicationCategory: 'DeveloperApplication',
         operatingSystem: 'Linux, Windows, macOS',
         description: route.description,
+        keywords: route.keywords,
         url: SITE_URL,
+        image: [`${SITE_URL}img/og.png`, image],
+        logo: { '@type': 'ImageObject', url: `${SITE_URL}logo.svg` },
+        author: { '@type': 'Person', name: 'Bangkah', url: 'https://github.com/Bangkahdev' },
+        downloadUrl: 'https://github.com/Bangkahdev/DevOpsGen/releases',
+        license: 'https://github.com/Bangkahdev/DevOpsGen#readme',
         offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' },
       },
       { '@type': 'BreadcrumbList', itemListElement: r },
     ],
   };
 
+  const ogSizeMeta = route.ogImage === 'img/og.png'
+    ? `  
+  
+`
+    : '';
+
   return `
 
 
@@ -58,17 +70,25 @@ export function renderDocument(route) {
   ${escapeHtml(route.title)}
   
   
+  
+  
+  
+  
+  
   
   
   
+  
   
   
   
   
-  
+  
+${ogSizeMeta}  
   
   
   
+  
   
   
 
diff --git a/docs/web/src/routes.jsx b/docs/web/src/routes.jsx
index abdfb1c..6c9315d 100644
--- a/docs/web/src/routes.jsx
+++ b/docs/web/src/routes.jsx
@@ -17,7 +17,7 @@ export const ROUTES = [
     description:
       'DevOpsGen generates production-ready Dockerfiles, GitHub Actions pipelines and Kubernetes manifests for Go and Node.js projects, with safe dry-run plans, automatic backups and config validation.',
     keywords: 'DevOpsGen, dockerfile generator, github actions generator, kubernetes manifests, go, nodejs, scaffolding, ci cd',
-    ogImage: 'img/init-success.png',
+    ogImage: 'img/og.png',
   },
   {
     path: 'getting-started',
diff --git a/docs/web/src/styles/site.css b/docs/web/src/styles/site.css
index 6f7fa22..53a70f3 100644
--- a/docs/web/src/styles/site.css
+++ b/docs/web/src/styles/site.css
@@ -102,17 +102,10 @@ body {
 }
 
 .brand-mark {
-  display: grid;
-  place-items: center;
+  display: block;
   width: 2.25rem;
   height: 2.25rem;
-  border-radius: var(--ui-radius);
-  background: var(--ui-accent-soft);
-  color: var(--ui-accent-strong);
   box-shadow: 0 2px 8px var(--ui-shadow-color);
-  font-family: var(--font-display);
-  font-size: 0.95rem;
-  font-weight: 700;
 }
 
 .brand-name {