From c8a74e114fff0f5ac96678ae6a63d85a0f7c49e2 Mon Sep 17 00:00:00 2001 From: naterfute Date: Tue, 20 Oct 2026 00:21:36 -0700 Subject: [PATCH 1/3] update zig version to be correct --- src/pages/index.astro | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/pages/index.astro b/src/pages/index.astro index c8749e5..6074f4a 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -11,9 +11,10 @@ const exampleUrl = 'https://github.com/gdzig/gdzig/tree/master/example';

Godot extensions in Zig

Idiomatic Zig bindings for Godot 4.

+

GDZig is under rapid development while the project shapes the API for Godot - 4.7.2 and Zig 0.16.0. Use it today with care, and expect bugs or missing + 4.7.2 and Zig 0.17.0. Use it today with care, and expect bugs or missing features before a stable release.

From a3f31823ff54f22ba191a21e43b0fd1d99188032 Mon Sep 17 00:00:00 2001 From: naterfute Date: Wed, 28 Oct 2026 00:22:56 -0700 Subject: [PATCH 2/3] feat: new landing page! --- src/layouts/SiteLayout.astro | 59 +++-- src/pages/index.astro | 223 +++++++++------- src/styles/landing.css | 479 +++++++++++++++++++++++++++++++++++ 3 files changed, 657 insertions(+), 104 deletions(-) create mode 100644 src/styles/landing.css diff --git a/src/layouts/SiteLayout.astro b/src/layouts/SiteLayout.astro index ce707ad..06a557f 100644 --- a/src/layouts/SiteLayout.astro +++ b/src/layouts/SiteLayout.astro @@ -6,9 +6,11 @@ import '../styles/home.css'; interface Props { title: string; description: string; + variant?: 'default' | 'landing'; } -const { title, description } = Astro.props; +const { title, description, variant = 'default' } = Astro.props; +const isLanding = variant === 'landing'; const repositoryUrl = 'https://github.com/gdzig/gdzig'; const discordUrl = 'https://discord.gg/GEUZGRGeDj'; @@ -18,6 +20,12 @@ const primaryLinks = [ { href: '/showcase/', label: 'Showcase' }, { href: '/docs/', label: 'Docs' }, ]; + +const footerLinks = [ + ...primaryLinks, + { href: repositoryUrl, label: 'GitHub' }, + { href: discordUrl, label: 'Discord' }, +]; --- @@ -83,9 +91,9 @@ const primaryLinks = [ {title} - + -
+
-
+
- + { + isLanding ? ( +
+
+

Build Godot games and extensions with Zig.

+ +
+
+ ) : ( +
+

Build Godot games and extensions with Zig.

+ +
+ ) + } diff --git a/src/pages/index.astro b/src/pages/index.astro index 6074f4a..9a359b3 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -1,110 +1,157 @@ --- import SiteLayout from '../layouts/SiteLayout.astro'; +import '../styles/landing.css'; +const godotVersion = '4.7.2'; +const zigVersion = '0.17.0'; const exampleUrl = 'https://github.com/gdzig/gdzig/tree/master/example'; + +const docSections = [ + { + href: '/docs/tutorials/', + title: 'Tutorials', + text: 'Guided learning paths will walk through complete GDZig projects from first build to Godot integration.', + }, + { + href: '/docs/how-to/', + title: 'How-to guides', + text: 'Task-focused guides will cover direct procedures such as building an extension and registering Godot-facing APIs.', + }, + { + href: '/docs/explanations/', + title: 'Explanations', + text: 'Concept pages will explain architecture, ownership, memory, and why generated API docs stay separate from guided docs.', + }, + { + href: '/docs/reference/', + title: 'Reference', + text: 'Curated project reference will collect supported versions, conventions, compatibility notes, and WebAssembly caveats.', + }, +]; --- -
-

Godot extensions in Zig

-

Idiomatic Zig bindings for Godot 4.

- -

- GDZig is under rapid development while the project shapes the API for Godot - 4.7.2 and Zig 0.17.0. Use it today with care, and expect bugs or missing - features before a stable release. -

-
- Read the docs +
+
+

Godot extensions in Zig

+

Idiomatic Zig bindings for Godot 4

+

Build Godot games and extensions with Zig

+

+ Zig {zigVersion} + + Godot {godotVersion} + + Rapid development +

+
+ Read the docs + Learn more +
+
+
+ +
+
+
+

Choose your path

+

Start with the work you need to do.

+
+
+
+ +

For extension developers

+

+ Start here if you want to build a Godot extension in Zig. The first + guides will cover project setup, class registration, and generated API + lookup. +

+
+
+ +

For game developers

+

+ Start here if you want to understand whether GDZig fits your Godot + project. Begin with the example project and project status notes. +

+
+
-
-
-

Choose your path

-

Start with the work you need to do.

-
-
-
-

For extension developers

-

- Start here if you want to build a Godot extension in Zig. The first - guides will cover project setup, class registration, and generated API - lookup. -

-
-
-

For game developers

-

- Start here if you want to understand whether GDZig fits your Godot - project. Begin with the example project and project status notes. -

-
+
+
+

Project status

+

+ GDZig is under rapid development while the project shapes the API for + Godot {godotVersion} and Zig {zigVersion}. +

+

Use it today with care.

+

Expect bugs or missing features before a stable release.

-
-
-

Human-written docs

-

Use the documentation type that matches your task.

-
-
-
-

Tutorials

-

- Guided learning paths will walk through complete GDZig projects from - first build to Godot integration. -

-
-
-

How-to guides

-

- Task-focused guides will cover direct procedures such as building an - extension and registering Godot-facing APIs. -

-
-
-

Explanations

-

- Concept pages will explain architecture, ownership, memory, and why - generated API docs stay separate from guided docs. -

-
-
-

Reference

-

- Curated project reference will collect supported versions, conventions, - compatibility notes, and WebAssembly caveats. -

-
+
+
+
+

Documentation

+

Use the documentation type that matches your task.

+
+

Human-written docs

+
+ { + docSections.map((section, index) => ( +
+ +

+ {section.title} +

+

{section.text}

+
+ )) + } +
-
-
-

Project updates and examples

-

Visible stubs keep future sections findable.

-
-
-
-

Planned

-

Blog

-

- Release notes and project updates will live here. Until then, follow - the repository for current changes. -

-
-
-

Draft

-

Showcase

-

- Community projects built with GDZig will appear here. Current entries - include Vector Wave and Godot Asset Store video plugins. -

-
+
+
+
+

Updates & examples

+

Visible stubs keep future sections findable.

+
+
+
+

Planned

+

Blog

+

+ Release notes and project updates will live here. Until then, follow + the repository for current changes. +

+
+
+

Draft

+

Showcase

+

+ Community projects built with GDZig will appear here. Current entries + include Vector Wave and Godot Asset Store video plugins. +

+
+
diff --git a/src/styles/landing.css b/src/styles/landing.css new file mode 100644 index 0000000..57b8f1c --- /dev/null +++ b/src/styles/landing.css @@ -0,0 +1,479 @@ +/* Landing page: full-bleed color bands, inspired by https://valvesoftware.github.io/steam-audio/ */ + +.pico[data-page='landing'] { + --landing-dark: #0f0c08; + --landing-dark-2: #17120b; + --landing-on-dark: #f8efe3; + --landing-on-dark-muted: #b9ab97; + --landing-accent: #f6a31d; + --landing-band-light: #e7ddcc; + --landing-band-lighter: #f3ede2; + --landing-on-light: #17130b; + --landing-on-light-muted: #4f463a; + --landing-rule: #17130b; + --landing-panel-from: rgba(255, 255, 255, 0.85); + --landing-panel-to: rgba(255, 255, 255, 0); +} + +:root[data-theme='dark'] .pico[data-page='landing'] { + --landing-band-light: #231c13; + --landing-band-lighter: #1b150e; + --landing-on-light: #f8efe3; + --landing-on-light-muted: #cbbca8; + --landing-rule: #f6a31d; + --landing-panel-from: rgba(255, 255, 255, 0.07); + --landing-panel-to: rgba(255, 255, 255, 0); +} + +@media (prefers-reduced-motion: no-preference) { + html:has(.pico[data-page='landing']) { + scroll-behavior: smooth; + } +} + +.pico[data-page='landing'] main { + padding: 0; +} + +.pico[data-page='landing'] main > section { + margin: 0; +} + +/* Transparent header laid over the hero */ +.pico[data-page='landing'] .site-header-overlay { + position: absolute; + top: 0; + right: 0; + left: 0; + z-index: 5; + padding-block: 1.5rem; +} + +.pico[data-page='landing'] .site-header-overlay a:not(.wordmark), +.pico[data-page='landing'] .site-header-overlay .mobile-nav summary { + color: var(--landing-on-dark); + font-size: 0.85rem; + font-weight: 700; + letter-spacing: 0.14em; + text-decoration: none; + text-transform: uppercase; +} + +.pico[data-page='landing'] .site-header-overlay a:not(.wordmark):hover { + color: var(--landing-accent); +} + +.pico[data-page='landing'] .site-header-overlay .wordmark { + color: #fff; + letter-spacing: 0.02em; +} + +.pico[data-page='landing'] .site-header-overlay .wordmark::before { + border-color: #fff; +} + +.pico[data-page='landing'] .site-header-overlay .theme-toggle { + color: var(--landing-on-dark); + border-color: rgba(248, 239, 227, 0.4); + background: transparent; +} + +.pico[data-page='landing'] .site-header-overlay .mobile-nav { + padding: 0.6rem 0.9rem; + background: rgba(15, 12, 8, 0.85); + border-radius: 0.5rem; +} + +/* Bands */ +.band { + padding-block: clamp(3.5rem, 8vw, 6rem); + text-align: center; +} + +.band-dark { + color: var(--landing-on-dark); + background: var(--landing-dark-2); +} + +.band-light { + color: var(--landing-on-light); + background: var(--landing-band-light); +} + +.band-lighter { + color: var(--landing-on-light); + background: var(--landing-band-lighter); +} + +.band-hero { + display: flex; + align-items: center; + min-height: min(100vh, 52rem); + padding-block: 9rem 5rem; + color: var(--landing-on-dark); + background: + radial-gradient(ellipse 60% 55% at 78% 18%, rgba(246, 163, 29, 0.32), transparent 70%), + radial-gradient(ellipse 50% 50% at 8% 95%, rgba(176, 98, 8, 0.3), transparent 70%), + repeating-linear-gradient( + 90deg, + rgba(255, 255, 255, 0.025) 0 1px, + transparent 1px 4.5rem + ), + linear-gradient(180deg, #0a0805 0%, #1a130a 100%); +} + +.band-hero .hero-content { + width: 100%; +} + +.band-glow { + color: var(--landing-on-dark); + background: + radial-gradient(ellipse 70% 90% at 50% 0%, rgba(246, 163, 29, 0.16), transparent 70%), + var(--landing-dark); +} + +.band-narrow { + max-width: 54rem; +} + +/* Hero typography */ +.band-hero h1, +.band-hero p { + color: inherit; +} + +.hero-kicker, +.hero-sub, +.hero-meta { + letter-spacing: 0.2em; + text-transform: uppercase; +} + +.hero-kicker { + margin-bottom: 1rem; + color: var(--landing-accent); + font-size: clamp(0.9rem, 1.6vw, 1.15rem); + font-weight: 700; +} + +.band-hero h1 { + max-width: 18ch; + margin: 0 auto 1.25rem; + font-size: clamp(2.25rem, 6vw, 4.5rem); + font-weight: 800; + line-height: 1.08; + letter-spacing: 0.08em; + text-transform: uppercase; +} + +.hero-sub { + margin-bottom: 1.5rem; + font-size: clamp(1rem, 2vw, 1.4rem); + font-weight: 300; +} + +.hero-meta { + display: flex; + flex-wrap: wrap; + align-items: center; + justify-content: center; + gap: 0.5rem 1rem; + margin-bottom: 2.5rem; + color: var(--landing-on-dark-muted); + font-size: 0.85rem; +} + +.hero-actions { + display: flex; + flex-wrap: wrap; + gap: 1rem; + justify-content: center; +} + +.hero-actions [role='button'] { + width: auto; + margin: 0; + padding: 0.85rem 2.25rem; + color: #17130b; + font-size: 0.9rem; + font-weight: 800; + letter-spacing: 0.16em; + text-transform: uppercase; + background: var(--landing-accent); + border: 2px solid var(--landing-accent); + border-radius: 0.25rem; +} + +.hero-actions [role='button']:hover { + background: #ffb743; + border-color: #ffb743; +} + +.hero-actions [role='button'].outline { + color: var(--landing-on-dark); + background: transparent; + border-color: rgba(248, 239, 227, 0.55); +} + +.hero-actions [role='button'].outline:hover { + color: #17130b; + background: var(--landing-on-dark); + border-color: var(--landing-on-dark); +} + +/* Section headings */ +.band-heading { + max-width: 40rem; + margin: 0 auto 3.5rem; +} + +.band-heading h2, +.band-title { + margin-bottom: 0.5rem; + color: inherit; + font-size: clamp(1.75rem, 4vw, 2.5rem); + font-weight: 800; + letter-spacing: 0.1em; + text-transform: uppercase; +} + +.band-heading p { + margin: 0; + color: var(--landing-on-dark-muted); + font-size: 1.05rem; +} + +.band-light .band-heading p, +.band-lighter .band-heading p { + color: var(--landing-on-light-muted); +} + +.rule-heading { + margin: 0 0 3rem; + padding-bottom: 0.5rem; + color: var(--landing-on-light); + font-size: 0.9rem; + font-weight: 800; + letter-spacing: 0.12em; + text-align: left; + text-transform: uppercase; + border-bottom: 6px solid var(--landing-rule); +} + +/* Feature columns */ +.columns { + display: grid; + gap: 2.5rem 2rem; +} + +.columns-2 { + grid-template-columns: repeat(auto-fit, minmax(min(100%, 20rem), 1fr)); + max-width: 56rem; + margin-inline: auto; +} + +.columns-4 { + grid-template-columns: repeat(2, 1fr); +} + +@media (max-width: 576px) { + .columns-4 { + grid-template-columns: 1fr; + } +} + +@media (min-width: 992px) { + .columns-4 { + grid-template-columns: repeat(4, 1fr); + } +} + +.pico[data-page='landing'] .feature { + position: relative; + margin: 0; + padding: 0 1rem; + background: none; + border: 0; + box-shadow: none; +} + +.feature-icon { + display: inline-grid; + place-items: center; + width: 5rem; + height: 5rem; + margin-bottom: 1.5rem; + color: var(--landing-accent); + border: 2px solid currentColor; + border-radius: 50%; +} + +.band-light .feature-icon, +.band-lighter .feature-icon { + color: var(--landing-on-light); +} + +.feature-icon svg { + width: 2.25rem; + height: 2.25rem; +} + +.feature-number { + font-size: 1.35rem; + font-weight: 800; + letter-spacing: 0.04em; +} + +.feature h3 { + margin-bottom: 1rem; + color: inherit; + font-size: 1rem; + font-weight: 800; + letter-spacing: 0.12em; + text-transform: uppercase; +} + +.feature h3 a { + color: inherit; + text-decoration: none; +} + +.feature h3 a:hover { + text-decoration: underline; + text-underline-offset: 0.3em; +} + +.feature p { + margin: 0; + color: var(--landing-on-dark-muted); +} + +.band-light .feature p, +.band-lighter .feature p { + color: var(--landing-on-light-muted); +} + +.card-links .feature h3 a::after, +.card-links .update h3 a::after { + position: absolute; + inset: 0; + content: ''; +} + +/* Status band */ +.status-lede { + margin-bottom: 1.5rem; + color: var(--landing-on-dark-muted); + font-size: clamp(1.1rem, 2.2vw, 1.5rem); + font-weight: 300; + line-height: 1.7; +} + +.status-lede strong { + color: var(--landing-on-dark); + font-weight: 700; +} + +.status-emphasis { + margin-bottom: 0.5rem; + color: var(--landing-accent); + font-size: clamp(1.75rem, 4vw, 2.5rem); + font-style: italic; + font-weight: 800; +} + +.status-note { + margin: 0; + color: var(--landing-on-dark-muted); + font-size: 1.1rem; + font-style: italic; +} + +/* Update panels */ +.pico[data-page='landing'] .update { + position: relative; + margin: 0; + padding: 2rem; + color: var(--landing-on-light); + text-align: left; + background: linear-gradient(to bottom, var(--landing-panel-from), var(--landing-panel-to)); + border: 0; + border-radius: 0; + box-shadow: none; +} + +.update h3 { + margin: 0 0 1rem; + padding-bottom: 0.6rem; + color: inherit; + font-size: 1rem; + font-weight: 800; + letter-spacing: 0.12em; + text-transform: uppercase; + border-bottom: 4px solid var(--landing-rule); +} + +.update h3 a { + color: inherit; + text-decoration: none; +} + +.update h3 a:hover { + text-decoration: underline; + text-underline-offset: 0.3em; +} + +.update p:not(.update-label) { + margin: 0; + color: var(--landing-on-light-muted); +} + +.update-label { + margin-bottom: 0.75rem; + color: var(--landing-on-light-muted); + font-size: 0.8rem; + font-weight: 700; + letter-spacing: 0.14em; + text-transform: uppercase; +} + +/* Footer */ +.landing-footer { + padding-block: 2rem; + color: #999; + background: #000; +} + +.landing-footer-inner { + display: flex; + flex-wrap: wrap; + align-items: center; + justify-content: space-between; + gap: 1rem 2rem; +} + +.landing-footer p { + margin: 0; + color: inherit; + font-size: 0.9rem; +} + +.landing-footer nav { + width: auto; +} + +.landing-footer ul { + flex-wrap: wrap; +} + +.landing-footer a { + color: #ccc; + font-size: 0.8rem; + letter-spacing: 0.12em; + text-transform: uppercase; +} + +.landing-footer a:hover { + color: var(--landing-accent); +} From 6d9680b7022bb7b426cffc59b825e1e9383bea41 Mon Sep 17 00:00:00 2001 From: naterfute Date: Wed, 28 Oct 2026 01:24:24 -0700 Subject: [PATCH 3/3] have ai do some checks to ensure I'm not dumb --- src/layouts/SiteLayout.astro | 1 + src/pages/index.astro | 1 - src/styles/home.css | 4 ++-- src/styles/landing.css | 27 ++++++++++++++------------- 4 files changed, 17 insertions(+), 16 deletions(-) diff --git a/src/layouts/SiteLayout.astro b/src/layouts/SiteLayout.astro index 06a557f..f80c86d 100644 --- a/src/layouts/SiteLayout.astro +++ b/src/layouts/SiteLayout.astro @@ -2,6 +2,7 @@ import PostHog from '../components/posthog.astro'; import '@picocss/pico/css/pico.conditional.min.css'; import '../styles/home.css'; +import '../styles/landing.css'; interface Props { title: string; diff --git a/src/pages/index.astro b/src/pages/index.astro index 9a359b3..e161252 100644 --- a/src/pages/index.astro +++ b/src/pages/index.astro @@ -1,6 +1,5 @@ --- import SiteLayout from '../layouts/SiteLayout.astro'; -import '../styles/landing.css'; const godotVersion = '4.7.2'; const zigVersion = '0.17.0'; diff --git a/src/styles/home.css b/src/styles/home.css index 543f6cc..f265d18 100644 --- a/src/styles/home.css +++ b/src/styles/home.css @@ -397,8 +397,8 @@ main > section:not(.hero), flex-direction: column; } - .primary-links, - .utility-links { + .pico .primary-links, + .pico .utility-links { display: none; } diff --git a/src/styles/landing.css b/src/styles/landing.css index 57b8f1c..15332b8 100644 --- a/src/styles/landing.css +++ b/src/styles/landing.css @@ -91,21 +91,25 @@ } .band-dark { + --pico-color: var(--landing-on-dark); color: var(--landing-on-dark); background: var(--landing-dark-2); } .band-light { + --pico-color: var(--landing-on-light); color: var(--landing-on-light); background: var(--landing-band-light); } .band-lighter { + --pico-color: var(--landing-on-light); color: var(--landing-on-light); background: var(--landing-band-lighter); } .band-hero { + --pico-color: var(--landing-on-dark); display: flex; align-items: center; min-height: min(100vh, 52rem); @@ -127,6 +131,7 @@ } .band-glow { + --pico-color: var(--landing-on-dark); color: var(--landing-on-dark); background: radial-gradient(ellipse 70% 90% at 50% 0%, rgba(246, 163, 29, 0.16), transparent 70%), @@ -138,11 +143,6 @@ } /* Hero typography */ -.band-hero h1, -.band-hero p { - color: inherit; -} - .hero-kicker, .hero-sub, .hero-meta { @@ -150,7 +150,7 @@ text-transform: uppercase; } -.hero-kicker { +.pico .hero-kicker { margin-bottom: 1rem; color: var(--landing-accent); font-size: clamp(0.9rem, 1.6vw, 1.15rem); @@ -159,6 +159,7 @@ .band-hero h1 { max-width: 18ch; + color: var(--landing-on-dark); margin: 0 auto 1.25rem; font-size: clamp(2.25rem, 6vw, 4.5rem); font-weight: 800; @@ -173,7 +174,7 @@ font-weight: 300; } -.hero-meta { +.pico .hero-meta { display: flex; flex-wrap: wrap; align-items: center; @@ -229,7 +230,7 @@ } .band-heading h2, -.band-title { +.pico .band-title { margin-bottom: 0.5rem; color: inherit; font-size: clamp(1.75rem, 4vw, 2.5rem); @@ -249,7 +250,7 @@ color: var(--landing-on-light-muted); } -.rule-heading { +.pico .rule-heading { margin: 0 0 3rem; padding-bottom: 0.5rem; color: var(--landing-on-light); @@ -362,7 +363,7 @@ } /* Status band */ -.status-lede { +.pico .status-lede { margin-bottom: 1.5rem; color: var(--landing-on-dark-muted); font-size: clamp(1.1rem, 2.2vw, 1.5rem); @@ -375,7 +376,7 @@ font-weight: 700; } -.status-emphasis { +.pico .status-emphasis { margin-bottom: 0.5rem; color: var(--landing-accent); font-size: clamp(1.75rem, 4vw, 2.5rem); @@ -383,7 +384,7 @@ font-weight: 800; } -.status-note { +.pico .status-note { margin: 0; color: var(--landing-on-dark-muted); font-size: 1.1rem; @@ -429,7 +430,7 @@ color: var(--landing-on-light-muted); } -.update-label { +.pico .update-label { margin-bottom: 0.75rem; color: var(--landing-on-light-muted); font-size: 0.8rem;