https://github.com/szymdzum/kumak-dev
Personal blog built with Astro and Deno, featuring markdown content and modern web technologies
https://github.com/szymdzum/kumak-dev
astro blog deno markdown typescript
Last synced: 3 months ago
JSON representation
Personal blog built with Astro and Deno, featuring markdown content and modern web technologies
- Host: GitHub
- URL: https://github.com/szymdzum/kumak-dev
- Owner: szymdzum
- License: mit
- Created: 2025-09-12T06:02:32.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-11-16T19:38:05.000Z (7 months ago)
- Last Synced: 2025-11-16T20:16:15.269Z (7 months ago)
- Topics: astro, blog, deno, markdown, typescript
- Language: Astro
- Size: 809 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Kumak's Blog
> Personal blog built with Astro, powered by Deno, and deployed to Deno Deploy.
[](https://github.com/szymdzum/kumak-dev/actions)
Features:
- ✅ Minimal styling (make it your own!)
- ✅ 100/100 Lighthouse performance
- ✅ SEO-friendly with canonical URLs and OpenGraph data
- ✅ Sitemap support
- ✅ RSS Feed support
- ✅ Markdown & MDX support
## 🚀 Tech Stack
- **Framework**: [Astro](https://astro.build) - Fast, content-focused web framework
- **Runtime**: [Deno](https://deno.com) - Secure JavaScript/TypeScript runtime
- **Hosting**: [Deno Deploy](https://deno.com/deploy) - Global edge deployment
- **Styling**: CSS with modern features and design tokens
- **Content**: Markdown with frontmatter and content collections
## 📁 Project Structure
```text
├── .github/ # GitHub workflows and templates
├── public/ # Static assets
├── src/
│ ├── components/ # Reusable UI components (.astro)
│ ├── content/ # Content collections & schemas
│ ├── layouts/ # Page templates
│ ├── pages/ # File-based routes
│ ├── styles/ # Global CSS
│ └── utils/ # TypeScript utilities
├── tests/ # Test files
├── astro.config.mjs # Astro configuration
├── deno.json # Deno configuration & tasks
└── site-config.ts # Site metadata
```
## 🧞 Development Commands
All commands use Deno tasks defined in `deno.json`:
| Command | Action |
| :------------------- | :---------------------------------------- |
| `deno task dev` | Start development server |
| `deno task build` | Build production site |
| `deno task preview` | Preview production build locally |
| `deno task deploy` | Deploy to Deno Deploy |
| `deno task test` | Run all tests |
| `deno task lint` | Lint code with Deno |
| `deno task format` | Format code with Deno |
| `deno task check-all`| Run all checks (lint + format + astro) |
## 🚀 Quick Start
```bash
# Clone the repository
git clone https://github.com/szymdzum/kumak-dev.git
cd kumak-dev
# Start development server
deno task dev
# Build for production
deno task build
# Deploy to production
deno task deploy
```
## 📜 Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development workflow and guidelines.
## 🚀 Deployment
The site is automatically deployed to [Deno Deploy](https://deno.com/deploy) on every push to `main`. The deployment is handled by GitHub Actions.
**Live Site**: [kumak.dev](https://kumak.dev) (coming soon)
## 📝 License
MIT License - see [LICENSE](./LICENSE) for details.
---
**Credits**: This blog is built on the excellent [Astro Blog Template](https://github.com/withastro/astro/tree/main/examples/blog) and inspired by [Bear Blog](https://github.com/HermanMartinus/bearblog/).