Marc Mintel
103d71851c
Some checks failed
🧪 CI (QA) / 🧪 Quality Assurance (push) Failing after 1m3s
- Restructure to pnpm monorepo (site moved to apps/web) - Integrate @mintel/tsconfig, @mintel/eslint-config, @mintel/husky-config - Implement Docker service architecture (Varnish, Directus, Gatekeeper) - Setup environment-aware Gitea Actions deployment
104 lines
3.1 KiB
Markdown
104 lines
3.1 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# Install dependencies
|
|
npm install
|
|
|
|
# Start dev server
|
|
npm run dev
|
|
|
|
# Build for production
|
|
npm run build
|
|
|
|
# Preview production build
|
|
npm run preview
|
|
```
|
|
|
|
## Writing Posts
|
|
|
|
1. Add post metadata to `src/data/blogPosts.ts`
|
|
2. Create a new `.astro` file in `src/pages/blog/`
|
|
3. Import and use the modular components
|
|
4. 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 styling
|
|
- `Paragraph`, `LeadParagraph` - Text with proper spacing
|
|
- `UL`, `OL`, `LI` - Lists with proper indentation
|
|
- `Blockquote`, `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
|
|
```bash
|
|
# 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
|
|
```bash
|
|
# Generate estimation with website crawl
|
|
npm run ai-estimate -- "Project Briefing" --url https://example.com
|
|
```
|
|
See [ESTIMATION_GUIDE.md](docs/ESTIMATION_GUIDE.md) for full documentation. |