brillout / brillout/docpress

Make the DocPress design swappable without forking

Open
#173 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
14
Forks
7
Avg merge
14m
Merged PRs (30d)
3

Description

Following the palette PR (#171): colors are now tokenized. The bigger goal is making the whole look swappable, so a redesign is a preset/config swap rather than a fork that one person owns. vike.dev stays byte-identical by default.

**The constraint**
vike-themes and DocPress don't compose at the layout level: each owns its own shell/renderer (DocPress isn't vike-react, so the vike-themes Wrapper hook doesn't apply). Today they only meet at the CSS-variable seam.

**Approaches to weigh (nothing decided yet)**
- Extend the CSS-var seam to layout: tokenize type scale, spacing, radii, a few layout dials (nav width, max-widths). Incremental, same shape as #171.
- A different mechanism: layout slots, deeper shell integration, or something else entirely. Open to better ideas.

Goal here is to agree the approach before building. No rush.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing palette PR #171 and the current CSS-variable seam. Compare how vike-themes and DocPress own their shell and renderer, then evaluate the proposed layout-token, slot, or deeper-integration approaches. Done means agreeing on an approach that makes the design swappable while keeping vike.dev byte-identical by default.

Written by the indexing model from the issue text.

Assessment

Tech stack
css, typescript
Domain
design, frontend, web-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
30/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.