# Shellside

> a kit for dual-surface portfolio sites

## packages

- [console-engine](/shellside/packages/console-engine): Terminal mechanics — parse/path/pipeline/runner/io plus fs and filter commands. Personality stays in the site.
- [console-vfs](/shellside/packages/console-vfs): Project filtered collections into a virtual filesystem — dirs, files, bins, char devices — for the console surface.
- [content-model](/shellside/packages/content-model): Schemas and the visibility contract — draft never leaks into public surfaces.
- [dev-api](/shellside/packages/dev-api): DEV-only desk machinery — content editor and the gated HTTP handler behind the admin surface.
- [edit-protocol](/shellside/packages/edit-protocol): The data-edit grammar, allowlists, path parsing, admin-preview URL helpers, and the typed preview-bridge contract.
- [look](/shellside/packages/look): Look roles, field-style maps, design-token and palette file factories, look history.
- [site](/shellside/packages/site): The config-driven host — this page is served by it.

## docs

- [ADR — the site-instance contract](/shellside/docs/site-instance-adr): site.config.ts + taste + content; the host injects generic surfaces.
- [Architecture — dual-surface system diagram](/shellside/docs/architecture): How content, visibility, the console VFS, and the dev desk fit together.
- [Divergences — marquee↔kit alignment log](/shellside/docs/divergences): Where the two trees speak differently, and what was reconciled.
- [Extraction map — what stays site-local vs kit](/shellside/docs/extraction-map): The ledger of every marquee piece promoted into a contract.
- [README — what shellside is](/shellside/docs/readme): The kit's own front page — contracts over copies, both surfaces, the desk.
- [Roadmap — release bars and phases](/shellside/docs/roadmap): R1 portability, R2 packaging, and the inversion into config-driven sites.

## releases

- [Marquee adoption](/shellside/releases/marquee-adoption): charlesberret.net consumes vendored packages — field styles, design tokens, edit protocol, console engine — live in production.
- [v0.1.0](/shellside/releases/v0-1-0): First cut — content-model, edit-protocol, look, dev-api contracts.
- [v0.2.0](/shellside/releases/v0-2-0): console-vfs + reference /console — the VFS surface shipped.
- [v0.3.0](/shellside/releases/v0-3-0): console-engine, @shellside/site host, create-site scaffold, leakAudit. Breaking (0.x): VFS node vocabulary.

## notes

- [This demo site, explained](/shellside/notes/itself)

## cv

- [Education](/shellside/cv/education)
- [Experience](/shellside/cv/experience)

## resume

- [Experience](/shellside/resume/experience)