Managed repository for Mosaic project nice-gee
Go to file
kbanc85 e536fbea15 Add live stats bar with calculated metrics
Added a prominent stats bar at the top of the homepage displaying real-time calculated metrics from the claims library data.

Features:
- Calculates all stats at build time from actual data
- Shows: articles count, total claims, avg tokens, optimal percentage
- Displays validation status and last update time
- Fully responsive with progressive disclosure
- Updates automatically on every build

Stats displayed:
- 24 articles (total article count)
- 120 claims (total atomic claims)
- ~15 avg tokens (calculated average across all claims)
- 95% optimal length (% of claims in 14-16 token range)
- ✓ Validated (build validation status)
- Updated X days/weeks ago (time since latest article)

Implementation:
- src/lib/stats.ts: Utility functions for calculating all metrics
- src/components/StatsBar.tsx: Responsive stats bar component
- Positioned at very top of page for immediate visibility
- Subtle styling (muted background, small text)
- Monospace font for token counts (precision signal)

Responsive behavior:
- Mobile: Core stats (articles, claims, tokens)
- Tablet (sm): Adds separators
- Desktop (md): Shows optimal percentage
- Large (lg): Full stats with validation and timestamps

Demonstrates expertise through:
✓ Systematic measurement (tracks everything)
✓ Quality metrics (validation, optimal percentage)
✓ Freshness signals (last updated)
✓ Precision (exact token counts)
✓ Zero backend needed (pure calculation)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-09 16:15:04 -05:00
.github/workflows Improve extraction scripts, validation, and documentation 2025-11-09 14:06:19 -05:00
public Update RSS feed build timestamp 2025-11-09 14:50:51 -05:00
scripts Enforce strict 12-18 token limit for all claims 2025-11-09 14:09:44 -05:00
src Add live stats bar with calculated metrics 2025-11-09 16:15:04 -05:00
.gitignore Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00
ADDING_NEW_CLAIMS.md Add 2 new claims pages using automated AI extraction 2025-11-04 14:29:42 -05:00
ARTICLE_PUBLICATION_DATES.md Order claims library by original article publication date (newest first) 2025-11-04 10:05:47 -05:00
AUTO_ARTICLE_SETUP.md Add automated article processing system 2025-11-05 21:31:07 -05:00
CITATION_SYSTEM_GUIDE.md Update guide with finalized pattern: full name + copy buttons 2025-11-04 11:02:07 -05:00
CLAIMS_PAGE_GUIDELINES.md Add strict image selection criteria for claims pages 2025-11-04 09:53:27 -05:00
DOCUMENTATION_INDEX.md Improve extraction scripts, validation, and documentation 2025-11-09 14:06:19 -05:00
DOMAIN_SETUP_GUIDE.md Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00
GEO_AUDIT_2025-11-04.md Major GEO optimization: Phase 1 complete 2025-11-04 10:33:46 -05:00
MIGRATION_SUMMARY.md Update all documentation to reflect current workflow and standards 2025-11-04 09:59:20 -05:00
NAMECHEAP_DNS_SETUP.md Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00
README.md Improve extraction scripts, validation, and documentation 2025-11-09 14:06:19 -05:00
VALIDATION_SYSTEM.md Clean up claims data and add validation system 2025-11-06 17:54:07 -05:00
WORKFLOW.md Add copy button to claim cards with full attribution 2025-11-09 14:34:03 -05:00
next.config.js Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00
package-lock.json Automate sitemap and RSS feed generation 2025-11-04 12:36:51 -05:00
package.json Clean up claims data and add validation system 2025-11-06 17:54:07 -05:00
postcss.config.js Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00
tailwind.config.ts Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00
tsconfig.json Initial commit: Next.js migration with SSG for GEO optimization 2025-11-04 08:36:52 -05:00

README.md

kbanc-nextjs

Next.js site for kbanc.com with static site generation for optimal GEO (Generative Engine Optimization).

Live Site

Auto-Deployment

This repository is connected to Netlify. Every push to main branch triggers automatic deployment.

Project Stats

  • Total Pages: ~30 static HTML files
  • Claims Pages: 26 individual claim articles
  • Build Time: ~3 seconds
  • GEO Optimized: ✅ Pre-rendered HTML + JSON-LD schema

Documentation

Setup & Deployment

  • MIGRATION_SUMMARY.md - Technical migration details
  • DOMAIN_SETUP_GUIDE.md - Custom domain setup instructions
  • NAMECHEAP_DNS_SETUP.md - Complete DNS configuration

Workflows

  • WORKFLOW.md - Complete process for creating new claims pages
  • CLAIMS_PAGE_GUIDELINES.md - Strict image selection criteria

Local Development

npm install
npm run dev
# Visit http://localhost:3000

Build for Production

npm run build
# Output: /out directory

Creating New Claims Pages

See WORKFLOW.md for the complete step-by-step process including:

  • Extracting atomic claims from articles
  • Strict image selection criteria (white bg, black text, red accents only)
  • Required file updates (sitemap, components, CSV)
  • Build and deployment checklist