Blog implementation

Author: tarunvelli

Gemfile

@@ -57,6 +57,8 @@ gem "devise_invitable", "~> 2.0"
 
 gem "dotenv", "~> 3.1"
 
+gem "redcarpet", "~> 3.6"
+
 group :development, :test do
   # See https://guides.rubyonrails.org/debugging_rails_applications.html#debugging-with-the-debug-gem
   gem "debug", platforms: %i[ mri windows ], require: "debug/prelude"

Gemfile.lock

@@ -209,7 +209,6 @@ GEM
     matrix (0.4.3)
     memory_profiler (1.1.0)
     mini_mime (1.1.5)
-    mini_portile2 (2.8.9)
     minitest (6.0.2)
       drb (~> 2.0)
       prism (~> 1.5)
@@ -230,9 +229,6 @@ GEM
       net-protocol
     net-ssh (7.3.0)
     nio4r (2.7.5)
-    nokogiri (1.19.1)
-      mini_portile2 (~> 2.8.2)
-      racc (~> 1.4)
     nokogiri (1.19.1-aarch64-linux-gnu)
       racc (~> 1.4)
     nokogiri (1.19.1-arm64-darwin)
@@ -319,6 +315,7 @@ GEM
       erb
       psych (>= 4.0.0)
       tsort
+    redcarpet (3.6.1)
     regexp_parser (2.11.3)
     reline (0.6.3)
       io-console (~> 0.5)
@@ -405,8 +402,6 @@ GEM
       fugit (~> 1.11)
       railties (>= 7.1)
       thor (>= 1.3.1)
-    sqlite3 (2.9.0)
-      mini_portile2 (~> 2.8.0)
     sqlite3 (2.9.0-aarch64-linux-gnu)
     sqlite3 (2.9.0-arm64-darwin)
     sqlite3 (2.9.0-x86_64-linux-gnu)
@@ -422,7 +417,6 @@ GEM
       railties (>= 6.0.0)
     stringio (3.2.0)
     thor (1.5.0)
-    thruster (0.1.18)
     thruster (0.1.18-aarch64-linux)
     thruster (0.1.18-arm64-darwin)
     thruster (0.1.18-x86_64-linux)
@@ -457,7 +451,7 @@ GEM
 PLATFORMS
   aarch64-linux
   arm64-darwin-23
-  ruby
+  arm64-darwin-25
   x86_64-linux
 
 DEPENDENCIES
@@ -486,6 +480,7 @@ DEPENDENCIES
   rack-mini-profiler
   rails (~> 8.1.2)
   rails_admin (~> 3.0)
+  redcarpet (~> 3.6)
   rspec-rails
   rubocop-rails-omakase
   rubocop-rspec

README.md

@@ -15,7 +15,7 @@
 
 1. **Pure Rails:** No proprietary DSLs or "magic". If you know Rails, you know this starter.
 2. **Readability > Cleverness:** Standard patterns over complex abstractions.
-3. **Batteries Included:** Authentication, Multi-tenancy, and UI components are pre-configured.
+3. **Batteries Included:** Authentication, Multi-tenancy, Blog, and UI components are pre-configured.
 
 ## Why this starter?
 
@@ -63,6 +63,34 @@ Overhaul the UI via the `AppSettings` singleton. No CSS hunting required. All se
 
 ---
 
+## Blog Engine
+
+A file-based markdown blog is included out of the box. Posts live in `content/blog/` as `.md` files with frontmatter:
+
+```yaml
+---
+title: My Post
+summary: A brief description
+date: 2024-01-15
+author: Author Name
+category: Tutorial
+published: true
+---
+
+# My Post
+
+Your content here...
+```
+
+**Features:**
+- Markdown rendering with syntax highlighting for code blocks
+- Categories and pagination
+- RSS feed at `/blog/feed`
+- SEO meta tags (Open Graph, Twitter Cards)
+- HTTP caching for fast page loads
+
+---
+
 ## ⚡ Quick Start
 
 ```bash

app/assets/stylesheets/blog.css.scss

@@ -0,0 +1,263 @@
+.blog-layout {
+  display: flex;
+  flex-direction: column;
+  min-height: 100vh;
+}
+
+.blog-layout main {
+  flex: 1;
+}
+
+.blog-layout .footer {
+  margin-top: auto;
+}
+
+.blog-header {
+  text-align: center;
+  padding: 3rem 0 3rem;
+}
+
+.blog-title {
+  font-size: 2.5rem;
+  font-weight: 700;
+  margin-bottom: 0.5rem;
+}
+
+.blog-subtitle {
+  font-size: 1.125rem;
+  color: var(--tblr-muted);
+}
+
+.blog-post {
+  max-width: 680px;
+  margin: 0 auto 3rem;
+  padding-bottom: 2rem;
+  border-bottom: 1px solid var(--tblr-border-color);
+}
+
+.blog-post:last-child {
+  border-bottom: none;
+}
+
+.blog-post-title {
+  font-size: 1.75rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+  line-height: 1.3;
+}
+
+.blog-post-title a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.blog-post-title a:hover {
+  color: var(--tblr-primary);
+}
+
+.blog-post-meta {
+  font-size: 0.875rem;
+  color: var(--tblr-muted);
+  margin-bottom: 1rem;
+}
+
+.blog-post-summary {
+  font-size: 1.125rem;
+  color: var(--tblr-secondary);
+  line-height: 1.6;
+  margin-bottom: 0;
+}
+
+.blog-newsletter {
+  max-width: 500px;
+  margin: 3rem auto;
+  padding: 2rem;
+  background: var(--tblr-light);
+  border-radius: 8px;
+  text-align: center;
+}
+
+.blog-newsletter h4 {
+  margin-bottom: 0.5rem;
+}
+
+.blog-newsletter p {
+  color: var(--tblr-muted);
+  margin-bottom: 1rem;
+}
+
+.blog-article {
+  max-width: 680px;
+  margin: 0 auto;
+  padding: 0 1rem;
+}
+
+.blog-article-header {
+  text-align: center;
+  margin-bottom: 2rem;
+  padding-bottom: 2rem;
+}
+
+.blog-category {
+  display: inline-block;
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--tblr-primary);
+  font-weight: 600;
+  margin-bottom: 1rem;
+}
+
+.blog-article-title {
+  font-size: 2.5rem;
+  font-weight: 700;
+  line-height: 1.2;
+  margin-bottom: 1rem;
+}
+
+.blog-article-meta {
+  font-size: 1rem;
+  color: var(--tblr-muted);
+}
+
+.blog-article-body {
+  font-size: 1.25rem;
+  line-height: 1.7;
+  color: var(--tblr-body-color);
+}
+
+.blog-article-body p {
+  margin-bottom: 1.5rem;
+}
+
+.blog-article-body h2 {
+  font-size: 1.75rem;
+  font-weight: 600;
+  margin-top: 2.5rem;
+  margin-bottom: 1rem;
+}
+
+.blog-article-body h3 {
+  font-size: 1.375rem;
+  font-weight: 600;
+  margin-top: 2rem;
+  margin-bottom: 0.75rem;
+}
+
+.blog-article-body ul, .blog-article-body ol {
+  margin-bottom: 1.5rem;
+  padding-left: 1.5rem;
+}
+
+.blog-article-body li {
+  margin-bottom: 0.5rem;
+}
+
+.blog-article-body pre {
+  background: #f6f8fa;
+  border: 1px solid #d0d7de;
+  border-radius: 8px;
+  padding: 1rem;
+  overflow-x: auto;
+  margin-bottom: 1.5rem;
+  font-size: 0.875rem;
+}
+
+.blog-article-body pre code {
+  background: transparent;
+  padding: 0;
+  font-size: inherit;
+}
+
+.blog-article-body code {
+  font-family: var(--tblr-font-monospace);
+  font-size: 0.9em;
+  background: #f6f8fa;
+  padding: 0.125rem 0.25rem;
+  border-radius: 4px;
+  color: #24292f;
+}
+
+.blog-article-body blockquote {
+  border-left: 3px solid var(--tblr-primary);
+  padding-left: 1rem;
+  margin: 1.5rem 0;
+  font-style: italic;
+  color: var(--tblr-secondary);
+}
+
+.blog-share {
+  max-width: 680px;
+  margin: 3rem auto;
+  padding: 1.5rem;
+  background: var(--tblr-light);
+  border-radius: 8px;
+  text-align: center;
+}
+
+.blog-share h5 {
+  margin-bottom: 0.5rem;
+}
+
+.blog-share p {
+  color: var(--tblr-muted);
+  margin-bottom: 1rem;
+  font-size: 0.9375rem;
+}
+
+.blog-back {
+  display: block;
+  text-align: center;
+  margin-top: 3rem;
+  color: var(--tblr-muted);
+  text-decoration: none;
+}
+
+.blog-back:hover {
+  color: var(--tblr-primary);
+}
+
+.blog-categories-header {
+  text-align: center;
+  padding: 3rem 0 2rem;
+  margin-bottom: 3rem;
+}
+
+.blog-categories-title {
+  font-size: 2.5rem;
+  font-weight: 700;
+  margin-bottom: 0.5rem;
+}
+
+.blog-categories-subtitle {
+  font-size: 1.125rem;
+  color: var(--tblr-muted);
+}
+
+.blog-category-card {
+  max-width: 400px;
+  margin: 0 auto 2rem;
+  padding: 1.5rem;
+  border: 1px solid var(--tblr-border-color);
+  border-radius: 8px;
+  text-decoration: none;
+  color: inherit;
+  transition: all 0.2s ease;
+}
+
+.blog-category-card:hover {
+  border-color: var(--tblr-primary);
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
+  transform: translateY(-2px);
+}
+
+.blog-category-name {
+  font-size: 1.25rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+}
+
+.blog-category-count {
+  font-size: 0.875rem;
+  color: var(--tblr-muted);
+}