initium-web

Document and enforce conventions for editing the Initium Next.js web app.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/CaDs/initium --skill initium-web
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: initium-web
Source: https://github.com/CaDs/initium/tree/main/.claude/skills/initium-web
Command: npx skills add https://github.com/CaDs/initium --skill initium-web

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documents and enforces the conventions for editing and extending the Initium Next.js web app.

Core Features & Use Cases

  • Enforces the repository-specific architecture (App Router, Server Actions, cookies, and Zod-based validation) to reduce PR churn.
  • Documents the contract-first workflow and the expected project structure for web-related changes.
  • Serves as a ready-to-consult guide for developers extending web/src, web/messages, and related test scenarios in Initium forks.

Quick Start

Run make dev to spin up the web app and begin implementing or modifying pages, actions, and i18n in the Initium web fork.

Frequently Asked Questions about initium-web

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is the contract-first workflow for Next.js web development?

To enforce Initium conventions, structure web/src using the App Router, place translations in web/messages, and implement Zod-based validation for Server Actions. This architecture standardizes pages, API routes, and middleware to maintain consistent review outcomes.

How do I structure internationalization (i18n) in a Next.js App Router project?

Initium web conventions require Zod-based validation for Server Actions and API routes. This enforces a contract-first workflow by validating data structures at the repository layout level, reducing PR churn and ensuring consistent tooling outcomes.

Does this Next.js convention guide support Server Actions and middleware?

Yes, the conventions explicitly support Next.js Server Actions and middleware. It codifies the repository layout under web/src, documenting required frontmatter fields and architecture to ensure consistent tooling and review outcomes for these features.

How do I start developing a web app using the Initium Next.js fork?

Run the make dev command to spin up the Initium web app locally. This allows you to begin implementing or modifying pages, Server Actions, and i18n content according to the documented contract-first workflow and project structure.

Why use Zod-based validation for Next.js Server Actions?

Zod-based validation enforces a contract-first workflow by validating data schemas before processing. In the Initium web app, this reduces PR churn by catching structural errors early and ensuring consistent architecture across Server Actions and API routes.

What are the limitations of using Initium web conventions for app development?

The conventions are strictly scoped to the Initium Next.js fork, specifically targeting web/src and web/messages. They do not cover external backend services or unrelated frontend frameworks, focusing solely on repository layout, i18n, and Server Actions.