Skip to content

fix(website): redesign — revert feature bloat, fix factual errors #66

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vraspar merged 1 commit into from
Mar 27, 2026
Merged

fix(website): redesign — revert feature bloat, fix factual errors #66

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
119 changes: 47 additions & 72 deletions website/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,47 +56,47 @@ <h2>How it works</h2>

<div class="steps-grid">
<div>
<div class="step-label">1. Create</div>
<div class="terminal" aria-label="Terminal showing brain init command">
<div><span class="prompt">$ </span><span class="command">brain init --name "My Team"</span></div>
<div class="step-label">1. Start</div>
<div class="terminal" aria-label="Terminal showing brain init and connect commands">
<div><span class="comment"># First person creates a brain</span></div>
<div><span class="prompt">$ </span><span class="command">brain init --name "Acme Engineering"</span></div>
<div class="output" style="white-space:pre">
✅ Brain "My Team" is ready!</div>
✅ Brain "Acme Engineering" is ready!</div>
<div>&nbsp;</div>
<div><span class="comment"># Teammates join it</span></div>
<div><span class="prompt">$ </span><span class="command">brain connect https://github.com/acme/brain-hub.git</span></div>
</div>
</div>

<div>
<div class="step-label">2. Import</div>
<div class="terminal" aria-label="Terminal showing brain ingest command">
<div><span class="prompt">$ </span><span class="command">brain ingest https://github.com/acme/docs.git</span></div>
<div class="output" style="white-space:pre">
✅ Ingested 24 entries from acme/docs
💡 8% stale. Run 'brain prune --dry-run' to review.</div>
</div>
</div>

<div>
<div class="step-label">3. Share</div>
<div class="terminal" aria-label="Terminal showing brain push command">
<div class="step-label">2. Add knowledge</div>
<div class="terminal" aria-label="Terminal showing brain push and ingest commands">
<div><span class="comment"># Push a single guide</span></div>
<div><span class="prompt">$ </span><span class="command">brain push ./guide.md</span></div>
<div class="output" style="white-space:pre">
✅ Pushed: Docker Multi-Stage Builds
Tags: docker (auto-detected)</div>
<div>&nbsp;</div>
<div><span class="comment"># Or import docs from a repo</span></div>
<div><span class="prompt">$ </span><span class="command">brain ingest https://github.com/acme/docs.git</span></div>
<div class="output" style="white-space:pre">
✅ Ingested 24 entries from acme/docs</div>
</div>
</div>

<div class="step-full">
<div class="step-label">4. Discover</div>
<div class="step-label">3. Discover</div>
<div class="terminal" aria-label="Terminal showing brain search command">
<div><span class="prompt">$ </span><span class="command">brain search "kubernetes"</span></div>
<div class="output" style="white-space:pre">
Found 3 results:
+------------------------+--------+-------+-----------+
| Title | Author | Type | Tags |
+------------------------+--------+-------+-----------+
| K8s Deployment Guide | bob | guide | k8s |
| CI Pipeline | carol | guide | ci, k8s |
| Helm Chart Patterns | alice | skill | helm, k8s |
+------------------------+--------+-------+-----------+</div>
┌────────────────────────┬────────┬───────┬───────────┐
│ Title │ Author │ Type │ Tags │
├────────────────────────┼────────┼───────┼───────────┤
│ K8s Deployment Guide │ bob │ guide │ k8s │
│ CI Pipeline │ carol │ guide │ ci, k8s │
│ Helm Chart Patterns │ alice │ skill │ helm, k8s │
└────────────────────────┴────────┴───────┴───────────┘</div>
</div>
</div>
</div>
Expand All @@ -115,39 +115,18 @@ <h3>Git as storage</h3>
</div>
<div class="card">
<h3>FTS5 search</h3>
<p>SQLite FTS5 with BM25 ranking, prefix matching, and contextual snippets. Sub-millisecond search. Works offline.</p>
</div>
<div class="card">
<h3>MCP server</h3>
<p>10 tools and 2 resources exposed via Model Context Protocol. AI agents can search, read, edit, and publish entries. <code>brain serve</code> starts the server.</p>
</div>
<div class="card">
<h3>Repo ingest</h3>
<p>Seed your brain from existing repos. <code>brain ingest &lt;url&gt;</code> scans for markdown, auto-detects titles and tags, and scores freshness at import.</p>
</div>
<div class="card">
<h3>Freshness scoring</h3>
<p>Entries scored as Fresh, Aging, or Stale based on recency and read frequency. <code>brain prune</code> archives what's stale. <code>brain restore</code> brings it back.</p>
</div>
<div class="card">
<h3>Knowledge trails</h3>
<p>Auto-computed links between entries. <code>brain trail &lt;topic&gt;</code> follows connections across your team's knowledge.</p>
</div>
<div class="card">
<h3>Interactive search</h3>
<p>Search results are numbered. Pick one to read it inline. <code>brain search "kubernetes"</code> then select. Records a read receipt.</p>
</div>
<div class="card">
<h3>Works with Obsidian</h3>
<p>Every brain is an Obsidian vault. Open it for graph view, backlinks, and visual editing. Wikilink footers connect related entries.</p>
<p>SQLite FTS5 with BM25 ranking, prefix matching, and contextual snippets. Sub-millisecond queries. Works offline. Index rebuilt from source on every sync.</p>
</div>
<div class="card">
<h3>21 commands</h3>
<p>push, search, list, show, digest, edit, open, ingest, prune, restore, trail, status, and more. All support <code>--format json</code>.</p>
<h3>MCP-native</h3>
<p>10 tools and 2 resources via Model Context Protocol. Your AI agent can search, read, edit, and publish entries. <code>brain serve</code> starts the server.</p>
</div>
</div>

<p class="section-also">Also: repo ingest · freshness scoring · knowledge trails · Obsidian vault · 20 commands</p>

<p class="section-punch">
<strong>Zero infrastructure. One command to start.</strong><br>
<code>brain connect https://github.com/acme/brain-hub.git</code>
</p>
</div>
Expand Down Expand Up @@ -205,26 +184,21 @@ <h2>Quick start</h2>
<div class="container">
<h2>Under the hood</h2>

<div class="arch-diagram" aria-label="Architecture diagram">
<div class="arch-label">brain push / brain search / brain digest</div>
<div class="arch-arrow-down"></div>
<div class="arch-box arch-box--accent">CLI</div>
<div class="arch-arrow-down"></div>
<div class="arch-row">
<div class="arch-box">
<span class="arch-accent">Git repo</span>
<span class="arch-sub">storage</span>
</div>
<div class="arch-box">
<span class="arch-accent">SQLite FTS5</span>
<span class="arch-sub">search</span>
</div>
<div class="arch-box">
<span class="arch-accent">Receipts</span>
<span class="arch-sub">analytics</span>
</div>
</div>
</div>
<pre class="arch-pre" aria-label="Architecture diagram">
brain push / brain search / brain digest
│
┌──────▼──────┐
│ <span class="arch-accent">CLI</span> │
└──────┬──────┘
│
┌────────────────┼────────────────┐
▼ ▼ ▼
┌──────────┐ ┌────────────┐ ┌──────────┐
│ <span class="arch-accent">Git repo</span> │ │ <span class="arch-accent">SQLite</span> │ │ <span class="arch-accent">Receipts</span> │
│ (storage)│ │ <span class="arch-accent">FTS5</span> │ │ (analytics│
│ │ │ (search) │ │ │
└──────────┘ └────────────┘ └──────────┘
</pre>

<div class="arch-notes">
<div class="arch-note">
Expand All @@ -248,10 +222,11 @@ <h2>Under the hood</h2>
<!-- Footer -->
<footer class="site-footer">
<div class="container">
<div>brain v0.4.1 · MIT License</div>
<div>brain v0.1.0-alpha · MIT License</div>
<div class="footer-links">
<a href="https://github.com/vraspar/brain">GitHub ↗</a>
<a href="https://github.com/vraspar/brain/tree/main/docs">Docs ↗</a>
<a href="https://github.com/vraspar/brain/blob/main/ROADMAP.md">Roadmap ↗</a>
</div>
</div>
</footer>
Expand Down
87 changes: 18 additions & 69 deletions website/style.css
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -350,6 +350,14 @@ a:focus-visible {
margin-right: 0;
}

.section-also {
text-align: center;
font-family: 'JetBrains Mono', monospace;
font-size: 0.85rem;
color: var(--text-muted);
margin: 0 auto 2rem;
}

.section-punch {
text-align: center;
color: var(--text-secondary);
Expand Down Expand Up @@ -416,73 +424,17 @@ a:focus-visible {
}

/* Architecture */
.arch-diagram {
display: flex;
flex-direction: column;
align-items: center;
gap: 0;
max-width: 600px;
margin: 0 auto 2rem;
}

.arch-label {
font-family: 'JetBrains Mono', monospace;
font-size: 0.85rem;
color: var(--text-muted);
margin-bottom: 0.5rem;
}

.arch-arrow-down {
width: 2px;
height: 24px;
background: var(--border);
position: relative;
}

.arch-arrow-down::after {
content: '';
position: absolute;
bottom: 0;
left: 50%;
transform: translateX(-50%);
border-left: 5px solid transparent;
border-right: 5px solid transparent;
border-top: 6px solid var(--border);
}

.arch-box {
.arch-pre {
font-family: 'JetBrains Mono', monospace;
font-size: 0.8rem;
border: 1px solid var(--border);
border-radius: 6px;
padding: 0.75rem 1.25rem;
text-align: center;
background: var(--bg-secondary, #141414);
display: flex;
flex-direction: column;
gap: 0.2rem;
}

.arch-box--accent {
border-color: var(--accent);
color: var(--accent);
font-weight: 600;
}

.arch-box .arch-sub {
font-size: 0.7rem;
color: var(--text-muted);
}

.arch-row {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 1rem;
width: 100%;
margin-top: 0.5rem;
line-height: 1.4;
color: var(--text-primary);
max-width: 600px;
margin: 0 auto 2rem;
overflow-x: auto;
}

.arch-accent {
.arch-pre .arch-accent {
color: var(--accent);
}

Expand Down Expand Up @@ -577,12 +529,9 @@ a:focus-visible {
grid-template-columns: 1fr;
}

.arch-row {
grid-template-columns: 1fr;
}

.arch-diagram {
padding: 0 1rem;
.arch-pre {
font-size: 0.7rem;
overflow-x: auto;
}

.terminal {
Expand Down
16 changes: 8 additions & 8 deletions website/terminal.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,13 +19,13 @@
command: 'brain search "kubernetes"',
output:
'Found 3 results:\n' +
'+------------------------+--------+-------+-----------+\n' +
'| Title | Author | Type | Tags |\n' +
'+------------------------+--------+-------+-----------+\n' +
'| K8s Deployment Guide | bob | guide | k8s |\n' +
'| CI Pipeline | carol | guide | ci, k8s |\n' +
'| Helm Chart Patterns | alice | skill | helm, k8s |\n' +
'+------------------------+--------+-------+-----------+',
'┌────────────────────────┬────────┬───────┬───────────┐\n' +
'│ Title │ Author │ Type │ Tags │\n' +
'├────────────────────────┼────────┼───────┼───────────┤\n' +
'│ K8s Deployment Guide │ bob │ guide │ k8s │\n' +
'│ CI Pipeline │ carol │ guide │ ci, k8s │\n' +
'│ Helm Chart Patterns │ alice │ skill │ helm, k8s │\n' +
'└────────────────────────┴────────┴───────┴───────────┘',
pauseAfter: 2500,
},
{
Expand Down Expand Up @@ -69,7 +69,7 @@
html +=
'<div><span class="prompt">$ </span><span class="command">' +
escapeHtml(step.command) +
'</span></div><div class="output">' +
'</span></div><div class="output" style="white-space:pre">' +
escapeHtml(step.output) +
'</div>';
if (i < DEMO_SEQUENCE.length - 1) html += '<div>&nbsp;</div>';
Expand Down
Loading