mmintelandClaude Opus 5.5
123ab8e354
The link preview used an old template with a blog description. The share image is now a screenshot of the real hero (scripts/render-share-image.mjs), served as Open Graph and Twitter image. Title and description come from one place and are used by the page, the previews and the structured data. Adds an apple touch icon and removes the old share-image template and its fonts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Technical Problem Solver's Blog
A clean, readable blog built with Astro and React. Focus on practical insights and learning notes.
Features
- Clean Architecture: Modular React components for article elements
- TypeScript: Full type safety throughout
- MDX Support: Write content with JSX components
- Fast: Static site generation with Astro
- Readable: Carefully designed typography and spacing
Project Structure
src/
├── components/ # Modular React components
│ ├── ArticleHeading.tsx
│ ├── ArticleParagraph.tsx
│ ├── ArticleList.tsx
│ ├── ArticleBlockquote.tsx
│ ├── BlogPostCard.tsx
│ └── Container.tsx
├── data/
│ └── blogPosts.ts # Blog post metadata
├── layouts/ # Astro layouts
│ ├── BaseLayout.astro
│ └── BlogLayout.astro
└── pages/ # Routes
├── index.astro # Home page
└── blog/ # Blog posts
├── first-note.astro
└── debugging-tips.astro
Development
# Install dependencies
npm install
# Start dev server
npm run dev
# Build for production
npm run build
# Preview production build
npm run preview
Writing Posts
- Add post metadata to
src/data/blogPosts.ts - Create a new
.astrofile insrc/pages/blog/ - Import and use the modular components
- The post will automatically appear on the home page
Components
The blog uses modular React components for article elements:
H1,H2,H3- Headings with consistent stylingParagraph,LeadParagraph- Text with proper spacingUL,OL,LI- Lists with proper indentationBlockquote,CodeBlock,InlineCode- Code and quotes
Design Philosophy
- Readability First: Clear typography, generous spacing
- No Distractions: Clean layout, focus on content
- Practical: Tools and techniques that work
- Calm: No hype, just facts
🎥 UI Showcase Toolkit
A Remotion-based toolkit for creating high-quality, deterministic showcase videos of our React components.
- Source of Truth: Renders real project components.
- Automated: CLI-driven rendering for LinkedIn-ready videos.
- Pixel-Perfect: 60fps, crisp text, brand-aligned style.
Quick Start
# Preview compositions
npm run video:preview
# Render the showcase video
npm run video:render
See .agent/workflows/video-toolkit.md for more details.
🤖 Industrial AI Estimation System
A multi-pass AI consultation engine for generating technical project estimations and professional PDFs.
- Context-Aware: Crawls existing customer websites to understand company DNA.
- Industrial Standards: Strictly follows "Industrial Engineering" aesthetics and technical wording.
- Transparent: Maps scope directly to a modular pricing model.
Quick Start
# Generate estimation with website crawl
npm run ai-estimate -- "Project Briefing" --url https://example.com
See ESTIMATION_GUIDE.md for full documentation.