This documentation is organized into focused modules for efficient reference:
- README.md - This overview and quick start guide
- project-overview.md - Technology stack and architecture
- article-creation-guide.md - Complete guide for creating new articles
- component-development-guide.md - Building interactive components
- styling-and-theming.md - CSS system and theming guide
- build-and-deployment.md - Build process and deployment
- content-management.md - Tags, search, RSS, and content organization
- troubleshooting.md - Common issues and solutions
- advanced-features.md - Analytics, performance, and accessibility
The Web Dev Simplified Blog is a static site built with Astro that focuses on web development education. The blog follows a strict Monday release schedule and is designed to provide high-quality technical content with interactive examples and comprehensive explanations.
- Release Schedule: Articles are published every Monday (all dates in the codebase follow this pattern)
- Content Focus: Web development tutorials, explanations, and technical discussions
- Interactive Learning: Heavy use of interactive components to demonstrate concepts
- Author: Kyle Cook (default author for all posts)
- Target Audience: Web developers of all skill levels
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production
npm run build- Create directory:
src/pages/YYYY-MM/article-slug/ - Add
index.mdxwith proper frontmatter - Ensure date is a Monday
- Add interactive components as needed
- New Article: See article-creation-guide.md
- Interactive Component: See component-development-guide.md
- Styling Issues: See styling-and-theming.md
- Build Problems: See troubleshooting.md
- Static Site Generator: Astro with component islands
- Content Format: MDX (Markdown + JSX)
- Interactive Components: React (only where needed)
- Styling: CSS custom properties with theming
- Deployment: Netlify with automatic builds
For detailed information, see the specific documentation files linked above.