# Aurora Core - Android Compose Example

Source-only Jetpack Compose implementation of the Aurora Core v5.4.0 design system.

## Requirements

- Kotlin 1.9+
- Jetpack Compose BOM 2024.01+ (Compose UI, Material 3, Foundation)
- Android SDK 24+

## Package Structure

```
com.auroracore.theme/
  AuroraTheme.kt          — Theme provider, spacing, radius, duration, easing, leading tokens
  AuroraColorTokens.kt    — Full dark/light palette, tone helpers, glass-depth tokens

com.auroracore.components/
  AuroraButton.kt          — Primary, Secondary, Tertiary, Ghost, Success, Warning, Danger variants
  AuroraToggle.kt          — Purple-to-blue liquid toggle (never gold — design rule)
  AuroraSlider.kt          — Tinted-track slider with gradient fill and shimmer
  AuroraBadge.kt           — Tonal badge with optional status dot
  AuroraProgressBar.kt     — Tinted-track progress bar with gradient fill
  AuroraCard.kt            — Glass-depth card (3 depth tiers, optical depth model)
  AuroraTextInput.kt       — Text input with gold focus ring, error state, disabled state
  AuroraAlert.kt           — Tonal alert banner (gold glows, amber is matte)
  AuroraTabs.kt            — Tab row with animated gold indicator

com.auroracore.preview/
  AuroraPreview.kt         — Full showcase of all components with @Preview annotations
```

## Integration

1. Copy the Kotlin files into your project's source tree.
2. Wrap your top-level composable with `AuroraCoreTheme` (or the shorthand `AuroraTheme`):

```kotlin
AuroraCoreTheme {
    // Your content here
}
```

3. Access design tokens through `AuroraThemeTokens`:

```kotlin
val colors = AuroraThemeTokens.colors
val spacing = AuroraThemeTokens.spacing
val radius = AuroraThemeTokens.radius
val depth = AuroraThemeTokens.depth
```

4. Use tone-aware helpers on the palette:

```kotlin
colors.accentFor(AuroraTone.Gold)
colors.trackTintFor(AuroraTone.Blue)
colors.gradientStopsFor(AuroraTone.Purple)
```

## Design Rules

These are non-negotiable Aurora Core rules enforced by every component:

| Rule | Detail |
|------|--------|
| Gold emits light | Gold (#E8D080 dark, #6E6020 light) gets glow shadows on hero elements |
| Amber does not glow | Amber is matte warning only -- no glow, no light emission |
| Optical depth | Use blur for depth; `.shadow()` is supplementary glow only, not elevation |
| Toggles use purple-to-blue | Never gold on toggles |
| Tinted tracks | Progress bars and sliders use a faint fill-color tint on tracks |
| No hardcoded hex | All colors reference palette/theme tokens |

## Preview

Each component file includes `@Preview` annotations for both dark and light themes.
The `AuroraPreview.kt` file provides a combined showcase of all components.

This folder is source-only in this repo. To compile it, copy the files into a real
Android/Compose module with Material 3 and Compose runtime dependencies.