Feature request: Allow basic customization of the welcome screen layout

Resolved 💬 3 comments Opened May 3, 2026 by stormzhang Closed May 6, 2026

Problem

Currently, Claude Code has two welcome screen layouts:

  • Full dashboard (with Tips, Recent Activity panels) — shown when no CLAUDE.md exists
  • Compact mode (just version, model, directory) — shown when CLAUDE.md exists

There is no way to customize either layout. Users who prefer the full dashboard style (with border, structured panels) in an already-initialized project are stuck with the compact view.

Proposal

Add a welcomeStyle setting (in settings.json or via /config) with a few lightweight options:

| Option | Behavior |
|--------|----------|
| auto (default) | Current behavior — full dashboard for new projects, compact for initialized ones |
| compact | Always use the minimal view |
| dashboard | Always use the full bordered dashboard view |

This is not about redesigning the welcome screen — just letting users pick which existing layout they see, regardless of project state.

Example

// ~/.claude/settings.json
{
  "welcomeStyle": "dashboard"
}

Why

The bordered dashboard layout looks cleaner and more organized. Some users prefer it as their default experience even in mature projects. A simple enum setting covers this without adding complexity.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗