Aughtone Format is a suite of Kotlin Multiplatform libraries designed to provide consistent, localized formatting for Dates, Times, Numbers, and other human-readable metrics across all platforms.

Aughtone Format 3.0.1 introduces new modules, API modernizations, performance optimizations, and timezone support:

• TimeZone Formatting: Implemented TimeZone.formatReadable extension functions in :readable to format timezone names with zero allocations.
• New Vector Modules: Introduced :viewable for platform-agnostic vector graphic representations, styling, and path conversion (SVG, WKT, GeoJSON), and :viewable-compose for Jetpack / Compose Multiplatform integration.
• API Naming Modernization: Deprecated old toReadable* prefix extension functions in favor of unified formatReadable* APIs for better readability and style guide alignment.
• AI-Skills Integration: Added machine-readable AI skills documentation for all modules to assist coding agents.

• :datetime: Advanced formatting for kotlinx-datetime types with multi-locale support.
• :readable: Human-friendly formatting for metrics (abbreviations), ordinals, and data sizes.
• :viewable: Platform-agnostic vector graphics representation, styling, and path conversion (GeoJSON, SVG, WKT).
• :viewable-compose: Jetpack / Compose Multiplatform integration for rendering viewable vector graphics (Painters, ImageVectors).
• :toolbox: Shared utilities and common formatting primitives.

This project follows a specialized 5-sector documentation hierarchy.

• 📐 Architecture: Engineering rules and design patterns.
• 🧠 Functional Specifications: Business logic and domain constraints.
• 🎨 Design & UI: Presentation layer and user stories.
• 📋 Acceptance Criteria: Success outcomes and verification.
• 📖 Developer Guide: Environment setup and onboarding.
• 📜 Changelog: History of changes and release notes.

• 65+ Languages Supported: Deep grammatical parity for Slavic, Arabic, Hebrew, Inuktitut, and more.
• Relative Time Formatting: Convert instants and dates into natural language (e.g., "5 minutes ago", "Yesterday").
• Automatic Fallback: Smartly switches from relative to absolute formatting based on configurable thresholds.
• Ordinal Numbers: Localized ordinal suffix support (e.g., 1st, 2nd, 3.º, 第1).
• Duration Scaling: Human-friendly duration strings with perceptual rounding (e.g., "2 weeks" vs "14 days").
• Numeric Abbreviations: Scaling large numbers into abbreviated forms (e.g., 1.5K, 1.2M).
• Geospatial Formatting: Localized altitude, azimuth (with cardinal directions), and coordinates.

The library provides deep grammatical parity for 65+ core languages and full BCP 47 subtag fallback (e.g., en-ZA → en).

val now = Clock.System.now()
// Format with styles (Short, Medium, Long, Full)
println(now.format(DateTimeStyle.Medium, locale = Locale("en"))) // "Apr 23, 2026, 4:15 PM"

// Ordinals
println(123L.formatReadableOrdinal(Locale("en"))) // "123rd"

// Durations
println(1.5.hours.formatReadable(Locale("en"))) // "1.5 hours"

// Relative Time
println(instant.formatReadableRelative(locale = Locale.current)) // "3 minutes ago"

// Data Sizes
println(1048576L.formatReadableDataSize()) // "1.0 MiB"

Access the Governance Skills for specialized development rules.

This library includes embedded, machine-readable "skills" to help AI assistants understand its APIs and best practices.

• Discovery: Look for META-INF/ai-skills/*.ai-skill.md

If you are using an AI assistant (like Claude, Gemini, or ChatGPT) to write code with this library, paste this prompt first:

"Scan all project dependencies for AI Skill files in META-INF/ai-skills/ with the prefix io.github.aughtone. Use these to understand the API patterns, types, and governance for this library. If they are not found in the local classpath, refer to the Aughtone Format GitHub repository for the source definitions."

To learn how to add this capability to your own library, see our AI Skill Publishing Standard.