Skip to content
UINUX
SystemProductsDocsChangelog
UINUX

Systems, not themes.v0.1.1

SystemProductsDocsChangelogLicense

© 2026 UINUX. All rights reserved.

hello@getuinux.com
← Products

UINUX Blog

v1.0

A calm, writing-first blogging system built with Astro. Designed for long-form writing. Typography, whitespace, and readability over visual complexity.

View on GitHubDocumentation

What's included

Components

6
  • Layout — page shell, meta, fonts
  • Nav — site navigation
  • Footer — site footer
  • Heading — typographic heading
  • Article — post wrapper with metadata
  • Prose — Markdown content styling

Pages

5
  • Home — post list
  • Search — client-side full-text search
  • About — static about page
  • RSS — feed at /rss.xml
  • Post — individual post pages via [...slug]

Built-in SEO

6
  • Canonical URLs on all pages
  • Open Graph meta (title, description, url, type, image)
  • Twitter Card meta
  • JSON-LD structured data (WebSite, BlogPosting, AboutPage)
  • Google Search Console verification via env var
  • RSS feed

Design Decisions

Serif body text

Newsreader — optimized for sustained reading. Long-form content deserves a typeface designed for it.

Sans-serif headings

Inter — clear hierarchy without competing with body text.

640px content width

Prevents eye fatigue on long lines. Optimal for reading.

No dark mode

One mode, one experience, no maintenance surface. Intentional simplicity.

Minimal client-side JS

Only used for search. All other pages are static HTML and CSS.

No component library

Six components, no more. Everything you need, nothing you don't.

Content Model

Posts require three frontmatter fields. No tags. No categories. No authors. Write and publish.

FieldTypeRequired
titlestringyes
descriptionstringyes
datedateyes

Example

---

title: "Your Post Title"

description: "A short description."

date: 2026-02-07

---

Your content here.

Project Structure

src/

components/

Layout.astro — page shell, meta, fonts

Nav.astro — site navigation

Footer.astro — site footer

Heading.astro — typographic heading

Article.astro — post wrapper with metadata

Prose.astro — Markdown content styling

content/

config.ts — content collection schema

posts/ — Markdown files go here

pages/

index.astro — home (post list)

search.astro — search page

search-index.json.ts — static search index

about.astro — about page

rss.xml.ts — RSS feed

posts/[...slug].astro — post pages

styles/

global.css — design tokens and base styles

Search

Client-side search powered by a static JSON index built at build time. No external services, no dependencies.

  • Index includes title, description, and full post body
  • Debounced input with instant results
  • Supports ?q= query parameter for direct linking
  • Available at /search

Technical Specs

FrameworkAstro 4
ContentMarkdown + MDX
StylingCSS (global.css with design tokens)
LanguageTypeScript
OutputStatic HTML, JS only for search
Body FontNewsreader (serif)
Heading FontInter (sans-serif)
Content Width640px
Dark ModeNo — one mode, one experience
Version1.0.0
LicenseMIT

Not for you if

You need a visual builder or CMS
You need dynamic content or user accounts
You need comments or newsletter signups
You need image galleries or portfolio features
You need analytics or growth tools built-in
You need dark mode or color presets

A quiet place to publish.

Write in Markdown. Deploy a static site. Nothing more.

View on GitHub