@oneie/plugin-blog 0.1.0

package/LICENSE

@@ -0,0 +1,86 @@
+# ONE License (Version 1.0)
+
+Copyright (c) 2024-2026 one.ie
+
+## Maximum Freedom, One Obligation
+
+This license empowers you with complete commercial freedom to use, reuse, modify, sell and resell the software, AI and data, at any price you wish.
+
+No usage limits. No royalty fees. Just pure, unrestricted ability to innovate and profit from the software.
+
+You are free to run ONE locally, on your own servers, in the cloud and at the edge.
+
+## You Receive
+
+### Unlimited Rights
+
+You have unrestricted rights to use, modify, license, sublicense, distribute, sell, resell and monetize the Software without restrictions, subject only to the Brand Requirement below.
+
+### Permitted Actions
+
+Including, but not limited to:
+
+- Commercial use and integration into any systems
+- Creation and sale of derivative works
+- Providing software as a service
+- AI training and content generation
+- Patenting innovations based on the Software
+- Open source applications and integrations
+
+### License Compatibility
+
+This license is compatible with all major open-source licenses, including:
+
+- MIT License
+- Apache License
+- GNU General Public License (GPL)
+- BSD Licenses
+- Mozilla Public License
+
+### Perpetual Rights
+
+These rights are granted in perpetuity and are irrevocable, provided the Brand Requirement is maintained.
+
+## Intellectual Property
+
+- We retain ownership of the original Software and data.
+- You own any modifications you make.
+- You never have to share your code or data.
+
+## Brand Requirement
+
+The only obligation is:
+
+- Don't remove the ONE brand, logo, and link to https://one.ie/ from the deployed product.
+
+To remove the Brand Requirement — white-label, no visible ONE branding — obtain the
+**ONE Enterprise License** (see `LICENSE-ENTERPRISE.md` or contact agent@one.ie).
+
+## Liability and Warranty
+
+The Software and data is provided "AS IS". We bear no liability for its use.
+
+## Termination
+
+This license terminates if you remove or hide the ONE brand, logo, or link without
+holding a current ONE Enterprise License.
+
+## Governing Law and Disputes
+
+This license is governed by the laws of Ireland. The parties will attempt to resolve disputes through good-faith negotiation. If necessary, disputes will proceed to mediation under the Mediators' Institute of Ireland rules, and then to binding arbitration under the Arbitration Act 2010, seated in Dublin, conducted in English.
+
+---
+
+This license is designed to maximize freedom to innovate and profit. There is no copyleft requirement to share any code, making it suitable for enterprise use.
+
+## Enterprise Solutions
+
+Building something big? We're here to help:
+
+- **Free** — use every feature with the ONE brand link in the footer
+- **White-label** — remove the brand requirement (ONE Enterprise License)
+- **Custom** — white-label solutions tailored to your needs
+- **Enterprise** — full support and deployment assistance
+- **Training** — help getting your team started
+
+Contact agent@one.ie to share your needs · Learn at https://one.ie/learn · Agents: https://one.ie/llms.txt

package/README.md

@@ -0,0 +1,134 @@
+# @oneie/plugin-blog
+
+ONE blog — Astro content collection with post grid, client-side search, RSS, and MDX support. Source ships to your repo (free tier).
+
+## Install
+
+```bash
+bun add @oneie/plugin-blog
+```
+
+## Setup
+
+### 1. Register the plugin
+
+```ts
+// one.config.ts
+import { defineOne } from '@oneie/frontend'
+import { blog } from '@oneie/plugin-blog'
+
+export default defineOne({
+  plugins: [
+    blog({
+      postsDir: 'src/content/blog', // default
+      rss: true,                    // emit /rss.xml
+      injectRoutes: true,           // add /blog and /blog/[slug]
+      postsPerPage: 12,
+    }),
+  ],
+})
+```
+
+### 2. Define the content collection
+
+```ts
+// src/content/config.ts
+import { defineCollection, z } from 'astro:content'
+
+const blog = defineCollection({
+  type: 'content',
+  schema: z.object({
+    title: z.string(),
+    description: z.string(),
+    date: z.coerce.date(),
+    category: z.string().optional(),
+    image: z.string().optional(),
+    tags: z.array(z.string()).optional(),
+  }),
+})
+
+export const collections = { blog }
+```
+
+### 3. Write posts
+
+```
+src/content/blog/
+  hello-world.mdx
+  second-post.md
+```
+
+Each file's frontmatter:
+
+```yaml
+---
+title: Hello World
+description: My first post on the ONE blog plugin.
+date: 2026-01-15
+category: Updates
+image: /images/hello.jpg
+tags: [one, astro, blog]
+---
+```
+
+## Using the components directly
+
+If you set `injectRoutes: false` (or want to customise the pages), import the components into your own pages.
+
+### BlogIndex page
+
+```astro
+---
+// src/pages/blog/index.astro
+import BlogIndex from '@oneie/plugin-blog/BlogIndex.astro'
+---
+
+<BlogIndex title="Our Blog" description="The latest from the team." />
+```
+
+### BlogPost page
+
+```astro
+---
+// src/pages/blog/[slug].astro
+import { getCollection } from 'astro:content'
+import BlogPost from '@oneie/plugin-blog/BlogPost.astro'
+
+export async function getStaticPaths() {
+  const posts = await getCollection('blog')
+  return posts.map((entry) => ({
+    params: { slug: entry.slug },
+    props: { entry },
+  }))
+}
+
+const { entry } = Astro.props
+const { headings } = await entry.render()
+---
+
+<BlogPost entry={entry} headings={headings} />
+```
+
+### PostCard and BlogSearch
+
+```tsx
+import { PostCard } from '@oneie/plugin-blog/PostCard.tsx'
+import { BlogSearch } from '@oneie/plugin-blog/BlogSearch.tsx'
+```
+
+## RSS
+
+When `rss: true` (the default), the plugin wires an RSS feed at `/rss.xml` via Astro's built-in RSS support. Link it in your `<head>`:
+
+```html
+<link rel="alternate" type="application/rss+xml" title="Blog RSS" href="/rss.xml" />
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `postsDir` | `string` | `'src/content/blog'` | Directory for blog MDX/MD files |
+| `rss` | `boolean` | `true` | Emit an RSS feed at `/rss.xml` |
+| `injectRoutes` | `boolean` | `true` | Auto-add `/blog` and `/blog/[slug]` routes |
+| `postsPerPage` | `number` | `12` | Posts shown per page in the index grid |

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@oneie/plugin-blog",
+  "version": "0.1.0",
+  "description": "ONE blog — Astro content collection with post grid, search, RSS, and MDX support",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./PostCard.tsx": "./src/PostCard.tsx",
+    "./BlogSearch.tsx": "./src/BlogSearch.tsx",
+    "./BlogIndex.astro": "./src/BlogIndex.astro",
+    "./BlogPost.astro": "./src/BlogPost.astro"
+  },
+  "peerDependencies": {
+    "astro": ">=6.0.0",
+    "@oneie/frontend": "*",
+    "react": ">=19.0.0"
+  },
+  "devDependencies": {
+    "astro": "^6.2.2",
+    "react": "^19.0.0",
+    "typescript": "^5.7.3"
+  },
+  "peerDependenciesMeta": {
+    "@oneie/frontend": {
+      "optional": true
+    }
+  }
+}

package/src/BlogIndex.astro

@@ -0,0 +1,41 @@
+---
+import { getCollection } from 'astro:content'
+import { BlogSearch } from './BlogSearch'
+
+export interface Props {
+  title?: string
+  description?: string
+}
+
+const {
+  title = 'Blog',
+  description = 'Thoughts, updates, and insights.',
+} = Astro.props
+
+const rawPosts = await getCollection('blog')
+
+const posts = rawPosts
+  .sort((a, b) => b.data.date.valueOf() - a.data.date.valueOf())
+  .map((entry) => ({
+    title: entry.data.title,
+    description: entry.data.description,
+    slug: entry.slug,
+    date: entry.data.date,
+    category: entry.data.category,
+    image: entry.data.image,
+    tags: entry.data.tags,
+  }))
+---
+
+<section class="relative overflow-hidden py-20 sm:py-28">
+  <div class="absolute inset-0 -z-10 bg-gradient-to-b from-muted/60 to-background" />
+  <div class="container mx-auto px-4 text-center">
+    <p class="text-sm font-semibold uppercase tracking-widest text-muted-foreground mb-3">Blog</p>
+    <h1 class="text-4xl sm:text-5xl font-bold tracking-tight mb-4">{title}</h1>
+    <p class="text-lg text-muted-foreground max-w-xl mx-auto">{description}</p>
+  </div>
+</section>
+
+<section class="container mx-auto px-4 pb-24">
+  <BlogSearch client:load posts={posts} />
+</section>

package/src/BlogPost.astro

@@ -0,0 +1,96 @@
+---
+import type { CollectionEntry } from 'astro:content'
+import type { MarkdownHeading } from 'astro'
+
+export interface Props {
+  entry: CollectionEntry<'blog'>
+  headings?: MarkdownHeading[]
+}
+
+const { entry, headings = [] } = Astro.props
+const { Content } = await entry.render()
+
+const { title, description, date, category, image } = entry.data
+
+const formattedDate = date.toLocaleDateString('en-US', {
+  year: 'numeric',
+  month: 'long',
+  day: 'numeric',
+})
+
+const tocHeadings = headings.filter((h) => h.depth <= 3)
+---
+
+<div class="container mx-auto px-4 py-12 max-w-6xl">
+  <!-- Back link -->
+  <a
+    href="/blog"
+    class="inline-flex items-center gap-1.5 text-sm text-muted-foreground hover:text-foreground transition-colors mb-8"
+  >
+    <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+      <path d="M19 12H5M12 5l-7 7 7 7"/>
+    </svg>
+    Back to blog
+  </a>
+
+  <div class="lg:grid lg:grid-cols-[1fr_240px] lg:gap-12">
+    <!-- Main content -->
+    <article>
+      {image && (
+        <div class="aspect-video overflow-hidden rounded-xl mb-8">
+          <img src={image} alt={title} class="w-full h-full object-cover" />
+        </div>
+      )}
+
+      <header class="mb-8">
+        {category && (
+          <span class="inline-block text-xs font-semibold uppercase tracking-widest text-muted-foreground mb-3">
+            {category}
+          </span>
+        )}
+        <h1 class="text-3xl sm:text-4xl font-bold tracking-tight mb-4">{title}</h1>
+        {description && (
+          <p class="text-lg text-muted-foreground mb-4">{description}</p>
+        )}
+        <div class="flex items-center gap-4 text-sm text-muted-foreground border-b pb-6">
+          <time datetime={date.toISOString()}>{formattedDate}</time>
+        </div>
+      </header>
+
+      <div class="prose prose-neutral dark:prose-invert max-w-none">
+        <Content />
+      </div>
+    </article>
+
+    <!-- TOC sidebar -->
+    {tocHeadings.length > 0 && (
+      <aside class="hidden lg:block">
+        <div class="sticky top-8">
+          <p class="text-xs font-semibold uppercase tracking-widest text-muted-foreground mb-3">
+            On this page
+          </p>
+          <nav>
+            <ul class="space-y-1.5 text-sm">
+              {tocHeadings.map((heading) => (
+                <li
+                  class:list={[
+                    'leading-snug',
+                    heading.depth === 2 && 'pl-0',
+                    heading.depth === 3 && 'pl-3',
+                  ]}
+                >
+                  <a
+                    href={`#${heading.slug}`}
+                    class="text-muted-foreground hover:text-foreground transition-colors"
+                  >
+                    {heading.text}
+                  </a>
+                </li>
+              ))}
+            </ul>
+          </nav>
+        </div>
+      </aside>
+    )}
+  </div>
+</div>

package/src/BlogSearch.tsx

@@ -0,0 +1,70 @@
+'use client'
+
+import { useState } from 'react'
+import { Input } from '@/components/ui/input'
+import { PostCard } from './PostCard'
+
+export interface BlogPost {
+  title: string
+  description: string
+  slug: string
+  date: Date
+  category?: string
+  image?: string
+  tags?: string[]
+}
+
+export interface BlogSearchProps {
+  posts: BlogPost[]
+  placeholder?: string
+  gridColumns?: '2' | '3'
+}
+
+export function BlogSearch({
+  posts,
+  placeholder = 'Search posts…',
+  gridColumns = '3',
+}: BlogSearchProps) {
+  const [query, setQuery] = useState('')
+
+  const filtered = query.trim()
+    ? posts.filter((post) => {
+        const q = query.toLowerCase()
+        return (
+          post.title.toLowerCase().includes(q) ||
+          post.description.toLowerCase().includes(q)
+        )
+      })
+    : posts
+
+  const gridClass =
+    gridColumns === '2'
+      ? 'grid grid-cols-1 sm:grid-cols-2 gap-6'
+      : 'grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-6'
+
+  return (
+    <div className="space-y-8">
+      <div className="flex justify-center">
+        <Input
+          type="search"
+          value={query}
+          onChange={(e) => setQuery(e.target.value)}
+          placeholder={placeholder}
+          className="max-w-md"
+        />
+      </div>
+
+      {filtered.length === 0 ? (
+        <div className="flex flex-col items-center justify-center py-16 text-center">
+          <p className="text-muted-foreground text-sm">No posts found for &ldquo;{query}&rdquo;.</p>
+        </div>
+      ) : (
+        <div className={gridClass}>
+          {filtered.map((post) => (
+            <PostCard key={post.slug} {...post} />
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}

package/src/PostCard.tsx

@@ -0,0 +1,83 @@
+import { Calendar, Clock } from 'lucide-react'
+import { Card, CardContent, CardHeader } from '@/components/ui/card'
+import { Badge } from '@/components/ui/badge'
+
+export interface PostCardProps {
+  title: string
+  description: string
+  slug: string
+  date: Date
+  category?: string
+  readingTime?: string
+  image?: string
+  tags?: string[]
+}
+
+function formatDate(date: Date): string {
+  return date.toLocaleDateString('en-US', {
+    year: 'numeric',
+    month: 'short',
+    day: 'numeric',
+  })
+}
+
+export function PostCard({
+  title,
+  description,
+  slug,
+  date,
+  category,
+  readingTime,
+  image,
+  tags,
+}: PostCardProps) {
+  return (
+    <a href={`/blog/${slug}`} className="block group focus:outline-none focus-visible:ring-2 focus-visible:ring-ring rounded-lg">
+      <Card className="h-full overflow-hidden transition-shadow duration-200 group-hover:shadow-md">
+        {image && (
+          <div className="aspect-video overflow-hidden">
+            <img
+              src={image}
+              alt={title}
+              className="w-full h-full object-cover transition-transform duration-300 group-hover:scale-105"
+            />
+          </div>
+        )}
+        <CardHeader className="pb-2">
+          {category && (
+            <Badge variant="secondary" className="w-fit mb-2 text-xs">
+              {category}
+            </Badge>
+          )}
+          <h2 className="text-lg font-semibold leading-snug group-hover:text-primary transition-colors line-clamp-2">
+            {title}
+          </h2>
+        </CardHeader>
+        <CardContent className="space-y-3">
+          <p className="text-sm text-muted-foreground line-clamp-2">{description}</p>
+          <div className="flex items-center gap-4 text-xs text-muted-foreground">
+            <span className="flex items-center gap-1">
+              <Calendar className="w-3.5 h-3.5" />
+              {formatDate(date)}
+            </span>
+            {readingTime && (
+              <span className="flex items-center gap-1">
+                <Clock className="w-3.5 h-3.5" />
+                {readingTime}
+              </span>
+            )}
+          </div>
+          {tags && tags.length > 0 && (
+            <div className="flex flex-wrap gap-1 pt-1">
+              {tags.slice(0, 3).map((tag) => (
+                <Badge key={tag} variant="outline" className="text-xs px-1.5 py-0">
+                  {tag}
+                </Badge>
+              ))}
+            </div>
+          )}
+        </CardContent>
+      </Card>
+    </a>
+  )
+}

package/src/index.ts

@@ -0,0 +1,53 @@
+import type { AstroIntegration } from 'astro'
+import type { OnePluginFactory } from '@oneie/frontend'
+
+export interface OneBlogConfig {
+  /** Directory where blog posts live. Default: 'src/content/blog' */
+  postsDir?: string
+  /** Emit an RSS feed at /rss.xml. Default: true */
+  rss?: boolean
+  /** Inject /blog and /blog/[slug] routes automatically. Default: true */
+  injectRoutes?: boolean
+  /** Posts per page for the index grid. Default: 12 */
+  postsPerPage?: number
+}
+
+const defaults: Required<OneBlogConfig> = {
+  postsDir: 'src/content/blog',
+  rss: true,
+  injectRoutes: true,
+  postsPerPage: 12,
+}
+
+export const blog: OnePluginFactory<OneBlogConfig> = (config = {}) => {
+  const resolved: Required<OneBlogConfig> = { ...defaults, ...config }
+
+  const integration = (_cfg: OneBlogConfig): AstroIntegration => ({
+    name: '@oneie/plugin-blog',
+    hooks: {
+      'astro:config:setup': ({ injectRoute }) => {
+        if (resolved.injectRoutes) {
+          injectRoute({
+            pattern: '/blog',
+            entrypoint: '@oneie/plugin-blog/BlogIndex.astro',
+          })
+          injectRoute({
+            pattern: '/blog/[slug]',
+            entrypoint: '@oneie/plugin-blog/BlogPost.astro',
+          })
+        }
+      },
+    },
+  })
+
+  return {
+    name: 'plugin-blog',
+    tier: 'free',
+    config: undefined,
+    integration,
+    entitlement: undefined,
+    serves: undefined,
+  }
+}
+
+export type { OneBlogConfig as BlogConfig }

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "jsx": "react-jsx",
+    "jsxImportSource": "react",
+    "paths": {
+      "@/*": ["../../apps/web/src/*"]
+    }
+  },
+  "include": ["src"]
+}