Command Palette

Search for a command to run...

AI Vibe Coding Manual & Tamil Site Guide

Design for Tamil.Build for everyone.

A bilingual design system for Tamil Nadu digital products — grounded in Tamil UX, human-centred design, and accessible-by-default components. Includes Kural AI chat, interactive Skills Tags, and a full developer operating manual.

WCAG AATamil-firstKural AI / SkillsVibe Coding
Tamil Design System Component Library Preview
50+
Documented components
Ready to copy-paste
WCAG AA
Accessibility target
Built-in from day one
Tamil + EN
Bilingual by default
Every component, both scripts
MIT
Open source license
Use it anywhere, free

Built for the realities of Tamil interfaces.

Every feature exists because English-first design systems leave Tamil products with broken typography, inaccessible controls, and no civic patterns. Tamil DS closes those gaps.

Tamil UX and civic interface illustration

Bilingual typography system

இருமொழி எழுத்துரு முறை

Inter for Latin, Noto Sans Tamil for Tamil — with CSS-scoped line-height interceptors that prevent vowel marker (மாத்திரை) clipping. font-tamil class applies safe 1.8 line-height only to text content nodes, never to interactive controls.

OKLCH semantic token system

OKLCH செமாண்டிக் டோக்கன் முறை

Violet brand accent, four clear radius steps (6 / 8 / 12 / 16 px), calibrated shadow scale, and full light + dark token sets in globals.css. All via Tailwind v4 CSS-first @theme — no tailwind.config.js.

Kural AI & Skills Tags

குறள் AI மற்றும் திறன் குறிச்சொற்கள்

Bilingual, schema-driven AI chat with slash-command skill tags (/வழிகாட்டி, /சுருக்கம், /தகுதி). Inline prompt composer with Plus, Settings2, Mic icons. Floating and static chat variants — both WCAG-compliant.

Accessibility by default

இயல்பிலேயே அணுகல்தன்மை

WCAG AA contrast, skip links, focus-visible rings, keyboard-reachable overlays, aria-labels in Tamil, screen-reader-safe heading hierarchy, and a persistent user-controlled a11y panel (text size, contrast, spacing, dyslexia font).

AI Vibe Coding operating manual

AI Vibe Coding இயக்க வழிமுறை

Full AI coding instructions: exact package versions, Tailwind v4 rules, @base-ui/react patterns, font-tamil scoping rules, theming foundation, file map and verification commands. Share the URL with any AI tool before it touches the codebase.

Human-centred civic patterns

மனித-மையப்படுத்திய குடிமை வடிவங்கள்

Production blocks for Tamil Nadu workflows: scheme comparisons, document portals, service dashboards, Aadhaar-style login, citizen help centres. Built from HCD research constraints — 375px mobile-first, mid-range Android, outdoor contrast.

Tamil Site Building Guide

தமிழ் தள கட்டுமான வழிகாட்டி

End-to-end guide: HTML lang=ta configuration, Next.js 16 + Noto Sans Tamil font loading, Tailwind v4 CSS-first setup, diacritic-safe container rules, bilingual navigation templates, and a deployment checklist.

Owned, copy-friendly source

சொந்த, நகல் எடுக்கக்கூடிய மூலக்குறியீடு

Local React primitives built on @base-ui/react 1.4.1 — not locked to a third-party library. Inspect, copy, and adapt any component. MIT licensed. Add via npx shadcn@latest add <component>.

Tamil UI · UX · CX · HCD — what these mean in practice.

Most design systems borrow English-first assumptions. Tamil DS is built on a different set of disciplines — ones that start with how Tamil is read, how Tamil citizens interact with services, and how to design from their context outward. These four disciplines define the quality bar.

Tamil UX

தமிழ் பயனர் அனுபவம்

Designing for how Tamil is actually read

Tamil script has vowel markers (மாத்திரை) that extend above and below the baseline. A UX layer that ignores this clips letters and breaks line rhythm. Tamil DS enforces diacritic-safe containers, 1.8 line-height ratios, and Noto Sans Tamil integration so the script renders the way it was meant to be read.

Tamil UX
Diacritic-safe line heightsMattirai-aware containersBilingual label parityLeft-to-right Tamil flow

Tamil CX

தமிழ் வாடிக்கையாளர் அனுபவம்

Tamil citizen experience, end to end

Customer Experience (CX) is the full arc from first impression to task completion. For a Tamil citizen, that includes reading service names easily and completing forms without translation friction. Tamil DS provides civic-grade patterns—like official tone and bilingual status flows—built for that complete arc.

Tamil CX
Official approachable toneScheme and document layoutsBilingual status flowsTrust-first visual hierarchy

Human-Centred Design

மனித-மையப்படுத்திய வடிவமைப்பு

Designed from the citizen's context outward

Human-Centred Design (HCD) starts with real people, not assumptions. For Tamil products, that means field research in Tamil, co-design sessions with local communities, and testing layouts on mid-range Android devices. Tamil DS is built around these real-world constraints and public-service contexts.

Human-Centred Design
Context-first user researchCo-design with communitiesMid-range device testingPublic interaction patterns

Accessibility

அணுகல்தன்மை

Accessible to everyone in Tamil Nadu

Accessibility in a Tamil context goes beyond WCAG guidelines. It means screen reader support for Tamil text, font scaling for older users, and contrast ratios that hold up in bright outdoor light. Tamil DS ships native accessibility controls—like text size and contrast mode—scoped directly to CSS tokens.

Accessibility
WCAG AA contrast baselineTamil screen reader supportOutdoor-safe contrast ratiosPersistent a11y controls

These disciplines are baked into the system — not added on top.

Every component, every token, and every guideline page in Tamil DS is written against this quality bar. The same bar applies to the AI vibe coding manual, so AI-generated code meets it too.

Read the UX laws

Designed for Tamil. Not adapted from English.

Generic design systems weren't designed with Tamil script, civic UX, or government colour trust in mind. Tamil DS was.

Tamil script rendering

Wrong font, incorrect line-height — Tamil māttirais clip or overlap

Noto Sans Tamil, correct 1.8 line-height, tested at every size

Bilingual layouts

English-only — Tamil text breaks grid assumptions

Every component has Tamil + English usage examples

Government colour trust

Generic brand palettes — not suited to civic contexts

Semantic tokens contrast-tested for public-service legibility

Real service context

Isolated UI demos with no domain knowledge

Scheme forms, Aadhaar flows, certificate trackers built in

Accessibility defaults

Bolted on later, or documented but not enforced

WCAG AA from default state — focus rings, ARIA, reduced-motion

Source ownership

Black-box npm package — hard to fork or customise

Full source in your repo — copy, adapt, and own it

Real controls, documented in service context.

Inputs, buttons, progress, and switches shown in workflows — not isolated decoration.

Browse components

Scheme application

Bilingual citizen service form

Draft

System settings — கணினி அமைப்புகள்

Immediate binary configurations

சேவை அறிவிப்புகளை பெறவும் / Receive service updates

SMS வழியாக நிலை மாற்றங்கள் / Send status changes by text

Review progress

68%
x

Document verification is in progress.

Biometric Authorization

கைரேகை சரிபார்ப்பு

Ready

Aadhaar Identity Gateway

Tap the scanner pad to authenticate citizen

ஆதார் சரிபார்ப்புGATEWAY: SECURE-POS-10A