Initial mcwaddams documentation site

Astro + Starlight documentation site for mcwaddams MCP server.

Features:
- Diátaxis documentation structure (tutorials, how-to, reference, explanation)
- Office Space theming (Milton Waddams, TPS Reports, red Swingline)
- 29 documentation pages covering all 20 tools
- TPS Reports section for test results
- Flair gamification config (pieces of documentation flair)
- Custom CSS with Office Space color scheme

Structure:
- Getting Started: backstory, installation, quickstart
- Tutorials: first extraction, legacy formats, indexing, resources
- How-To: tables, Excel analysis, markdown, pagination, URLs
- Reference: all tools, universal/word/excel tools, MCP resources, formats
- Explanation: architecture, mixins, fallbacks, resource system
- TPS Reports: dashboard, coverage, torture tests
- Community: credits, feedback, leaderboard
This commit is contained in:
Ryan Malloy 2026-01-11 12:21:49 -07:00
commit 32b41f79d9
42 changed files with 10513 additions and 0 deletions

182
src/styles/custom.css Normal file
View file

@ -0,0 +1,182 @@
/* mcwaddams - Office Space themed documentation */
/* "I was told there would be document extraction." */
@import "tailwindcss";
/* ==================== Color Theme ==================== */
/* Red Swingline stapler as primary accent */
:root {
--sl-color-accent-low: #450a0a; /* red-950 */
--sl-color-accent: #dc2626; /* red-600 - The Swingline */
--sl-color-accent-high: #fca5a5; /* red-300 */
/* Amber as secondary (Office Space retro vibe) */
--sl-color-text-accent: #f59e0b;
/* Slightly warmer backgrounds */
--sl-color-bg-nav: hsl(220, 20%, 8%);
--sl-color-bg-sidebar: hsl(220, 18%, 10%);
/* Custom properties for Office Space elements */
--os-stapler-red: #dc2626;
--os-amber: #f59e0b;
--os-corporate-gray: #374151;
--os-basement-dark: #0f172a;
}
/* ==================== Typography ==================== */
:root {
--sl-font: 'Inter', system-ui, sans-serif;
--sl-font-mono: 'JetBrains Mono', 'Fira Code', monospace;
}
/* ==================== Hero Customization ==================== */
.hero {
background:
linear-gradient(135deg, rgba(185, 28, 28, 0.1) 0%, transparent 50%),
radial-gradient(ellipse at bottom, rgba(245, 158, 11, 0.05) 0%, transparent 70%);
}
/* ==================== Sidebar Badges ==================== */
/* TPS Reports badge styling */
[data-badge-text="Testing Painful Stuff"] {
background: linear-gradient(135deg, #dc2626 0%, #b91c1c 100%) !important;
color: white !important;
font-weight: 600;
text-transform: uppercase;
font-size: 0.65rem;
letter-spacing: 0.05em;
}
/* Make badges more visible */
.sl-badge {
font-weight: 500;
}
/* ==================== Code Blocks ==================== */
/* Office-appropriate code styling */
.expressive-code {
--ec-brdRad: 0.5rem;
}
/* ==================== Cards & Callouts ==================== */
/* "Did you get the memo?" style callouts */
.starlight-aside--tip {
border-left-color: var(--os-amber);
}
.starlight-aside--caution {
border-left-color: var(--os-stapler-red);
}
/* ==================== Footer Easter Egg ==================== */
footer {
position: relative;
}
footer::after {
content: "I believe you have my stapler...";
position: absolute;
right: 1rem;
bottom: 0.5rem;
font-size: 0.7rem;
color: rgba(255, 255, 255, 0.2);
opacity: 0;
transition: opacity 0.3s ease;
pointer-events: none;
}
footer:hover::after {
opacity: 1;
}
/* ==================== Scrollbar Styling ==================== */
::-webkit-scrollbar {
width: 8px;
height: 8px;
}
::-webkit-scrollbar-track {
background: var(--sl-color-bg-sidebar);
}
::-webkit-scrollbar-thumb {
background: var(--sl-color-gray-5);
border-radius: 4px;
}
::-webkit-scrollbar-thumb:hover {
background: var(--os-stapler-red);
}
/* ==================== Links ==================== */
a:hover {
color: var(--os-amber);
}
/* ==================== Tables (TPS Report style) ==================== */
table {
border-collapse: collapse;
}
th {
background: linear-gradient(180deg, #374151 0%, #1f2937 100%);
text-transform: uppercase;
font-size: 0.75rem;
letter-spacing: 0.1em;
}
/* ==================== Film Grain Overlay (subtle) ==================== */
body::before {
content: "";
position: fixed;
top: 0;
left: 0;
width: 100%;
height: 100%;
pointer-events: none;
z-index: 9999;
opacity: 0.015;
background-image: url("data:image/svg+xml,%3Csvg viewBox='0 0 200 200' xmlns='http://www.w3.org/2000/svg'%3E%3Cfilter id='noise'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='4' stitchTiles='stitch'/%3E%3C/filter%3E%3Crect width='100%25' height='100%25' filter='url(%23noise)'/%3E%3C/svg%3E");
}
/* ==================== Animations ==================== */
@keyframes subtle-pulse {
0%, 100% { opacity: 1; }
50% { opacity: 0.8; }
}
/* Logo hover effect */
.site-title img {
transition: transform 0.3s ease;
}
.site-title:hover img {
transform: rotate(-5deg) scale(1.1);
}
/* ==================== Mobile Responsiveness ==================== */
@media (max-width: 768px) {
footer::after {
display: none;
}
}
/* ==================== Reduced Motion ==================== */
@media (prefers-reduced-motion: reduce) {
* {
animation-duration: 0.01ms !important;
transition-duration: 0.01ms !important;
}
}
/* ==================== Print Styles ==================== */
@media print {
body::before {
display: none;
}
footer::after {
display: none;
}
}

1
src/styles/global.css Normal file
View file

@ -0,0 +1 @@
@import "tailwindcss";