Apps Ose Www Developing Content

OSE Platform Web Content Development Skill

Purpose

This Skill provides guidance for creating and managing content on the ose-web Next.js 16 content platform which serves as an English-only project landing page.

When to use this Skill:

• Creating platform updates on ose-web
• Writing about page content
• Managing landing page structure
• Configuring markdown frontmatter
• Understanding ose-web specific patterns

Core Concepts

Site Overview

ose-web (apps/ose-www/):

• Site: oseplatform.com
• Theme: Next.js 16 (App Router, TypeScript, tRPC)
• Purpose: English-only project landing page
• Content Types: Platform updates, about page
• Structure: Flat, simple organization

English-Only Content

NO Multi-Language Structure:

• All content in English
• No language subdirectories
• Simple, flat content organization
• No bilingual content management

Content Structure

apps/ose-www/content/
├── updates/                               # Platform updates
│   ├── _index.md
│   ├── 2025-12-07-initial-release.md    # Date-prefixed
│   └── 2025-11-20-announcement.md        # Date-prefixed
└── about.md                               # About page

Simplicity principle: No deep hierarchies, no complex organization.

Date-Prefixed Filenames

Update Post Naming

CRITICAL: All update posts use date prefix for automatic chronological sorting

Format: YYYY-MM-DD-title.md

Examples:

• 2025-12-07-beta-release.md
• 2025-11-20-platform-announcement.md
• 2025-10-15-architecture-overview.md

Rationale:

• Automatic chronological ordering (no weight management needed)
• Clear publication date from filename
• Easy sorting in file system

About Page Naming

Format: Simple slug without date prefix

Example: about.md

Next.js 16 Frontmatter

See Next.js 16 Frontmatter for the required fields, recommended fields, Next.js-16-specific fields (ToC, metadata display, search/SEO, cover image), and the per-post author field rules.

Content Types, Links, and Assets

See Content Types, Links, and Assets for update-post and about-page frontmatter examples, internal-link format, and static asset organization.

Next.js 16 Features and Comparison

See Next.js 16 Features and ayokoding-web Comparison for navigation, theme toggle, social sharing, home page configuration, and the full ose-web-vs-ayokoding-web comparison table.

Common Patterns and Best Practices

See Common Patterns and Best Practices for the update-post and about-page creation steps, plus the update-post workflow and about-page maintenance checklists.

Content Validation Checklist and Common Mistakes

See Validation Checklist and Common Mistakes for the pre-publish checklist and the four most common ose-web content mistakes with correct fixes.

Deployment Workflow

See Deployment Workflow for the prod-ose-www production branch, the scheduled automated-deployment GitHub Actions workflow, the emergency force-push procedure, and why force-push is safe for deployment branches.

Reference Documentation

Related Conventions: Content Quality Principles

Related Skills: apps-ayokoding-www-developing-content, docs-creating-accessible-diagrams

Related Agents: apps-ose-www-content-maker, apps-ose-www-content-checker, apps-ose-www-deployer

External Resources: Next.js 16 Documentation

This Skill packages essential ose-web development knowledge for creating simple, effective landing page content. For comprehensive details, consult the primary convention document.