Codebolt Website

This repository contains the Codebolt marketing website. The active deployable site is the static Astro project in newsite/. The older Agent Sitegen flow remains in content/, template/, and site/ as deprecated reference material and should not be edited for durable homepage changes unless the user explicitly asks for that legacy flow.

Quickstart

npm install
npm run build
npm test

The production build output is written to newsite/dist/.

Common Commands

npm run dev        # start Astro dev server for newsite
npm run build      # build the static newsite output
npm test           # build and validate required SEO/GEO assets
npm run lint       # run the static newsite validator
npm run typecheck  # syntax-check Astro config and validation scripts
npm run deploy     # build and deploy with Wrangler

Active Layout

newsite/
  astro.config.mjs            # Static Astro build config
  DESIGN.md                   # Design rules for consistent pages
  theme.tokens.json           # Shared colors, typography, nav, and SEO defaults
  src/
    layouts/BaseLayout.astro  # Shared document shell, SEO, header, footer
    components/               # Shared Header and Footer components
    pages/                    # Public Astro routes
    content/                  # Page body HTML extracted from the original static pages
    styles/                   # Page-specific CSS
    scripts/                  # Page-specific client scripts
  public/
    images/                   # Product surface screenshots and previews
    images-withoutbackground/ # Transparent/product images
    robots.txt                # Search crawler entry point
    sitemap.xml               # Search index map
    llms.txt                  # LLM-readable site summary
    ai.txt                    # GEO-oriented crawler summary
  wrangler.jsonc              # Cloudflare Workers static assets config

scripts/
  validate-newsite.mjs        # Static checks for required pages, metadata, and assets

docs/
  architecture.md             # Site architecture and deployment notes
  development.md              # Development workflow for agents and humans
  seo-geo.md                  # SEO/GEO checklist for this static site

Example Workflow

For a homepage copy, layout, or SEO update:

npm run build
npm test

If the output is deployable:

npm run deploy

Deployment

The active site deploys as a Cloudflare Workers static assets project from newsite/wrangler.jsonc.

GitHub builds should run the root build command:

npm run build

Deployment should run from newsite/ or through the root deploy script:

npm run deploy

Do not replace this with wrangler pages deploy unless the Cloudflare target changes from Workers static assets to Cloudflare Pages.

Legacy Sitegen Flow

These scripts are retained for reference only:

npm run sitegen:generate
npm run sitegen:validate
npm run sitegen:build
npm run sitegen:dev

Use them only when the user explicitly asks to work on the deprecated generated Astro site.