docs: redesign repo presentation for SSS-tier visual appeal#39
Merged
Conversation
- Add golangci-lint with 25+ linters (.golangci.yml) - Add CodeQL SAST scanning (Go + JavaScript) - Add container publishing to ghcr.io (multi-arch amd64/arm64) - Add cosign release signing + SBOM generation (SPDX) - Add Codecov integration (informational mode) - Add semantic PR title enforcement - Add auto-labeler by file path - Add lock-threads workflow (30 days) - Add stale issue bot (60 days warn, 14 days close) - Add benchmark regression detection in CI - Add dependency review (block vulnerable new deps) - Add Go native fuzz testing in CI - Add OpenSSF Scorecard workflow + badge - Pin ALL GitHub Actions to full SHA (supply chain hardening) - Add GOVERNANCE.md (versioning, release process, supply chain) - Update dependabot: monthly → weekly, increased PR limits - Update README: 8 badges, Docker pull, cosign verify instructions - Update SECURITY.md: supply chain security section - Fix E2E test: dismiss wizard scrim before metrics interaction
golangci-lint v2.12.2 requires 'version: "2"' in config. Also removes 'typecheck' linter (always-on in v2).
- Move linters-settings under linters.settings (v2 schema) - Move issues.exclude-rules under linters.exclusions.rules (v2 schema) - Remove benchmark-action dependency (requires gh-pages branch) - Simplify to artifact-only benchmark results
max-issues-per-linter and max-same-issues are not valid under linters.exclusions in v2. Default (0 = unlimited) is what we want.
In v2, gofmt/gofumpt/goimports are formatters, not linters.
Pre-existing lint issues in the codebase should not block PRs. Only new code introduced in a PR is checked.
Same fix as metrics.spec.ts — fresh server shows wizard scrim that blocks tab clicks.
Each page.goto() re-triggers the scrim on fresh server. Dismiss after every navigation, not just in beforeEach.
Mobile viewport may have different hit targets. Force click bypasses actionability checks. Added small delay after dismissal for render.
- Add dark/light SVG banners with brand palette (system font stack) - Add animated terminal demo SVG showing quick start flow - Add social preview image (1280x640 PNG + SVG source) - Redesign README: hero section, centered badges, dot-nav links, 'Why Kiroxy?' pillars, comparison table, 2x3 screenshot grid - Polish CONTRIBUTING.md: tables, collapsibles, visual hierarchy - Add .github/release.yml for GitHub native release notes categories - Update goreleaser footer: Docker pull, cosign note, community links - Add og:image + twitter:image to landing page Layout.astro - Use system font stacks in SVGs (GitHub strips external font loads)
…llapsibles - Upgraded SVG banners: gradient backgrounds, ambient glow, stats row - Badges: flat-square → for-the-badge with kiroxy amber palette - Structure: collapsible details for reference sections (env vars, API, CLI, Docker) - Why Kiroxy: 2x2 card grid instead of table - Screenshots: image-first with caption below (Dub/Supabase pattern) - Architecture: simplified ASCII diagram - Footer: Repobeats placeholder for activity chart - Overall: less text above fold, more visual breathing room
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Complete visual overhaul of the GitHub repo presentation, making it elegant, tasteful, and visually appealing at first glance.
Changes
New Assets (
.github/assets/)README Redesign
<picture>dark/light adaptive banner (Biome/Drizzle pattern)<br>spacingCONTRIBUTING.md Polish
<details>sectionsInfrastructure
.github/release.yml— GitHub native release notes with emoji categories.goreleaser.yml— Docker pull command + cosign note + community links in footerLayout.astro— Addedog:image,og:site_name,twitter:image,summary_large_imagesocial-preview.pngin landing public dir for OG servingGitHub Settings (via API)
Design Patterns Used
<picture>dark/light adaptive SVGManual Steps Needed After Merge
.github/assets/social-preview.pngvia Settings → General → Social previewVerification