> ## Content Index
> Fetch the complete content index at: https://design-bytes.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# A Modern Web Starter
- URL: https://design-bytes.com/modern-web-starter/
- Published: 2026-11-18T11:58:00.000Z
- Updated: 2026-11-19T01:37:22.000Z
- Description: A lean, opinionated foundation using semantic HTML, modern CSS with cascade layers, and vanilla JavaScript.
- Author: Peter Kaizer
- Tags: Resource, #Import 2026-11-18 20:25

## The problem

The modern web stack has a complexity problem. Most starter templates pull in multiple frameworks, dozens of dependencies, and layers of build tooling before a single line of product code is written. For small projects, side projects, and design explorations, this overhead isn't just unnecessary — it actively gets in the way.

CSS specificity conflicts, utility-class sprawl, and the cognitive overhead of framework churn are real friction points. I wanted a foundation that solved these problems structurally, not by piling on more abstractions.

## Approach

The guiding constraint was zero dependencies. No framework, no preprocessor, no build step required to get started — just semantic HTML, modern CSS, and vanilla JavaScript with ES modules.

The architectural bet was CSS cascade layers. Rather than fighting specificity with `!important` or relying on utility classes for overrides, cascade layers make the order of precedence explicit: `reset → tokens → base → components → utilities`. Every rule knows exactly where it sits. Adding a new component layer never breaks an existing one.

The token system follows three tiers: primitives (raw values), semantic tokens (purpose-mapped aliases), and component tokens (scoped overrides). This separation means you can retheme an entire interface by changing a handful of semantic tokens without touching component code.

## Key decisions

**Fluid type scale over breakpoint-based sizes.** All type sizes use `clamp()` to scale smoothly between viewport extremes — no font-size overrides at arbitrary breakpoints.

**Light and dark mode built in.** The starter respects `prefers-color-scheme` by default and supports localStorage persistence so user preference survives page loads without a flash of wrong theme.

**CLAUDE.md included.** The repo ships with a `CLAUDE.md` file that documents project conventions for AI coding assistants. This reflects how the project was built — with Claude Code as a collaborative tool throughout — and makes the same workflow available to anyone who picks up the starter.

## Outcome

The result is a starter that weighs almost nothing but scales further than most projects will need. Five page layout templates, base components (buttons, badges, callouts, code blocks), and a token system that's genuinely easy to extend. The headline stat: 0 dependencies, infinite customizability.

[Visit Modern Web Starter](https://modern-web-starter.com/?ref=design-bytes.com)