taskbean.ai

Marketing site for taskbean — task management for AI coding agents, with a local CLI and human-facing app. Deployed via GitHub Pages at taskbean.ai.

No build step, no bundler, no package manager. Vanilla HTML/CSS/JS only.

Structure

Path	What it is
index.html, about.html, how-it-works.html	Standalone marketing pages with shared nav/footer markup
docs.html	Redirect interstitial for docs.taskbean.ai
css/style.css	Full design system in one file — @layer cascade, coffee-themed design tokens
js/main.js	Nav scroll, mobile toggle, scroll reveal, smooth scroll
assets/	Brand assets, hero art, app screenshots, OG image
vendor/lucide.min.js	Vendored icon library (no CDN)
scripts/validate-site.mjs	Dependency-free site integrity checks
CNAME	taskbean.ai — GitHub Pages custom domain

Local development

# Easiest — just open it:
start index.html            # Windows
open  index.html            # macOS

# Or serve it (for relative paths + service worker testing):
python -m http.server 8765

Edit any HTML/CSS/JS file and refresh. Icons auto-render via <i data-lucide="icon-name"></i>.

Validation

node scripts/validate-site.mjs

CI also performs a non-blocking availability check for the canonical product and documentation endpoints.

Conventions

• BEM naming — block__element--modifier (e.g. nav__link--external)
• .reveal class — add to any element for a scroll-triggered entrance animation
• .container — centering wrapper using --max-w and --gutter
• Navigation markup is duplicated across the three content pages — update every page when editing nav
• Product claims come from taskbean/taskbean
• Canonical documentation is managed exclusively in taskbean/docs; do not recreate a local docs/ tree in this repository

Deployment

• main is deployed automatically via GitHub Pages
• CNAME maps the site to taskbean.ai
• docs.taskbean.ai is deployed from the taskbean/docs repository

Tech

Vanilla HTML5, CSS3 (@layer, custom properties), vanilla JS, Lucide icons, Umami analytics.

Contributing

Small site, low ceremony. Open a PR against main, or use the configured agent-merge flow with its normal review gates. When touching layout or shared styles, verify on desktop (1440×900) and mobile (375×812).

License

MIT