@rosetears/aili-pi 0.1.0

package/skills/android-native-dev/references/design-style-guide.md

@@ -0,0 +1,365 @@
+# Design Style Guide
+
+Match visual design to app category and target audience for cohesive user experience.
+
+## Style Selection Principle
+
+> **The visual style must match the app's purpose and audience.**
+> A finance app should feel trustworthy, not playful.
+> A children's app should feel fun, not corporate.
+
+## Style Selection Matrix
+
+| App Category | Visual Style | Color Palette | Typography | Interaction |
+|--------------|--------------|---------------|------------|-------------|
+| Utility/Tool | Minimalist | Neutral + 1 accent | Clean sans-serif | Direct, efficient |
+| Finance/Banking | Professional Trust | Blue/Green/Navy | Conservative | Secure, deliberate |
+| Health/Wellness | Calm & Natural | Soft greens, earth tones | Rounded, friendly | Gentle, encouraging |
+| Kids (3-5) | Playful Simple | Bright primary colors | Large, rounded | Big targets, forgiving |
+| Kids (6-12) | Fun & Engaging | Vibrant, varied | Bold, readable | Gamified feedback |
+| Social/Entertainment | Expressive | Brand-driven | Dynamic | Gesture-rich |
+| Productivity | Clean & Focused | Minimal, high contrast | Professional | Keyboard-friendly |
+| E-commerce | Conversion-focused | Brand + CTA colors | Scannable | Quick actions |
+| Gaming | Immersive | Theme-driven | Stylized | Custom gestures |
+
+## Detailed Style Profiles
+
+### Minimalist / iOS-like (Utility Apps)
+
+**When to use**: Tools, utilities, calculators, file managers, settings apps
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | 2-3 colors max, neutral base |
+| Whitespace | Generous, 24-48dp margins |
+| Typography | Single font family, clear hierarchy |
+| Icons | Line-based, consistent stroke |
+| Shadows | Subtle or none |
+| Borders | Thin (1dp) or none |
+| Shapes | Subtle corners (8-12dp) |
+
+**Interaction Style**:
+- Direct manipulation
+- Immediate feedback
+- No unnecessary animations
+- Efficient task completion
+
+**Color Palette**:
+
+| Role | Light Mode | Dark Mode |
+|------|------------|-----------|
+| Background | #FAFAFA | #1C1C1E |
+| Surface | #FFFFFF | #2C2C2E |
+| Primary | #007AFF | #0A84FF |
+| Text | #000000 | #FFFFFF |
+| Secondary | #8E8E93 | #8E8E93 |
+
+**Reference Apps**: iOS Settings, Apple Notes, Google Calculator
+
+---
+
+### Professional Trust (Finance/Business)
+
+**When to use**: Banking, investment, enterprise, B2B applications
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | Blues, greens, navy (trust colors) |
+| Whitespace | Structured, grid-based |
+| Typography | Formal, conservative weights |
+| Icons | Filled or outlined, consistent |
+| Data visualization | Clear, accurate charts |
+| Security indicators | Prominent locks, badges |
+
+**Interaction Style**:
+- Confirmatory (double-check important actions)
+- Deliberate (not rushed)
+- Secure-feeling
+- Clear feedback on transactions
+
+**Color Palette**:
+
+| Role | Color | Name |
+|------|-------|------|
+| Primary | #00695C or #1565C0 | Teal 800 / Blue 800 |
+| Secondary | #37474F | Blue Grey 800 |
+| Accent | #FFC107 | Amber |
+| Background | #ECEFF1 | Blue Grey 50 |
+| Success | #2E7D32 | Green 800 |
+| Error | #C62828 | Red 800 |
+
+**Key Patterns**:
+- Balance summaries prominent
+- Transaction history easily scannable
+- Secure entry for sensitive data
+- Biometric authentication prompts
+
+**Reference Apps**: Banking apps, Trading platforms, Enterprise tools
+
+---
+
+### Calm & Wellness (Health Apps)
+
+**When to use**: Meditation, fitness tracking, health monitoring, therapy
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | Soft, muted, natural |
+| Whitespace | Abundant (breathing room) |
+| Typography | Rounded, friendly fonts |
+| Shapes | Organic, soft corners (16dp+) |
+| Animation | Gentle, slow transitions |
+| Imagery | Nature, soft gradients |
+
+**Interaction Style**:
+- Encouraging, not demanding
+- Progress-oriented
+- Gentle reminders
+- Celebration of achievements
+
+**Color Palette**:
+
+| Role | Color | Name |
+|------|-------|------|
+| Primary | #4CAF50 | Green 500 |
+| Secondary | #81C784 | Green 300 |
+| Tertiary | #B2DFDB | Teal 100 |
+| Background | #F1F8E9 | Light Green 50 |
+| Text | #33691E | Light Green 900 |
+| Accent | #FFB74D | Orange 300 |
+
+**Key Patterns**:
+- Progress rings and charts
+- Streak tracking
+- Motivational messages
+- Quiet notification style
+
+**Reference Apps**: Headspace, Calm, Apple Fitness
+
+---
+
+### Playful & Kid-Friendly (Children's Apps)
+
+**When to use**: Educational games, children's content, family apps
+
+#### Ages 3-5
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | Bright, saturated primary colors |
+| Touch targets | 56dp minimum, 64dp recommended |
+| Shapes | Very rounded (full radius) |
+| Typography | Large (18sp+ minimum), simple fonts |
+| Icons | Large, colorful, recognizable |
+| Animation | Frequent, rewarding |
+
+**Interaction Style**:
+- Simple gestures only (tap, drag)
+- No multi-finger gestures
+- Forgiving error handling
+- Immediate, multi-sensory feedback (sound + visual + haptic)
+- No text-only buttons
+
+**Color Palette**:
+
+| Role | Color | Name |
+|------|-------|------|
+| Primary | #F44336 | Red 500 |
+| Secondary | #FFEB3B | Yellow 500 |
+| Tertiary | #2196F3 | Blue 500 |
+| Background | #FFFFFF | White or soft pastels |
+| Accent | #4CAF50 | Green 500 |
+
+#### Ages 6-12
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | Vibrant, varied palette |
+| Touch targets | 48dp minimum |
+| Shapes | Rounded but can be varied |
+| Typography | Bold, readable, can include text |
+| Icons | Stylized, character-driven |
+| Animation | Gamified, achievement-based |
+
+**Interaction Style**:
+- Can introduce some complexity
+- Gamification elements
+- Progress and rewards
+- Some text is acceptable
+
+**Key Patterns for All Kids Apps**:
+- Icon-based navigation (no text-only)
+- Home button always visible
+- Back navigation clear
+- Parent gate for settings (math problem, hold button)
+- Multi-sensory feedback
+- Encouraging error states (no punishment)
+- Joint engagement opportunities with parents
+
+**Reference Apps**: PBS Kids, Khan Academy Kids, Duolingo ABC
+
+---
+
+### Expressive & Social (Entertainment Apps)
+
+**When to use**: Social media, content creation, entertainment
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | Bold brand colors |
+| Typography | Dynamic, personality-driven |
+| Media | Rich, prominent |
+| Animation | Expressive, delightful |
+| Shapes | Brand-specific |
+
+**Interaction Style**:
+- Gesture-rich
+- Quick actions
+- Social interactions prominent
+- Content-first design
+
+**Key Patterns**:
+- Feed-based layouts
+- Quick action buttons (like, share, comment)
+- Stories/ephemeral content
+- Creation tools accessible
+- Notification badges
+
+**Reference Apps**: Instagram, TikTok, Snapchat
+
+---
+
+### Clean & Focused (Productivity Apps)
+
+**When to use**: Note-taking, task management, email, documents
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | High contrast, minimal |
+| Whitespace | Strategic, content-focused |
+| Typography | Highly readable, clear hierarchy |
+| Icons | Functional, consistent |
+| Density | Adjustable (compact to comfortable) |
+
+**Interaction Style**:
+- Keyboard-friendly
+- Batch operations
+- Drag and drop
+- Quick capture
+- Search-centric
+
+**Color Palette**:
+
+| Role | Light Mode | Dark Mode |
+|------|------------|-----------|
+| Primary | #1976D2 | #64B5F6 |
+| Background | #FFFFFF | #121212 |
+| Surface | #F5F5F5 | #1E1E1E |
+| Text | #212121 | #E0E0E0 |
+| Accent/Priority | #FF5722 | #FF7043 |
+
+**Key Patterns**:
+- List views with swipe actions
+- Quick add buttons
+- Checkbox interactions
+- Due dates and reminders
+- Tags and categories
+
+**Reference Apps**: Notion, Todoist, Google Tasks
+
+---
+
+### Conversion-Focused (E-commerce)
+
+**When to use**: Shopping, marketplace, booking apps
+
+**Visual Characteristics**:
+
+| Element | Specification |
+|---------|---------------|
+| Colors | Brand + clear CTA colors |
+| Images | High quality, zoomable |
+| Typography | Scannable, price prominent |
+| Cards | Product-focused |
+| Badges | Sale, new, limited |
+
+**Interaction Style**:
+- Quick add to cart
+- Easy checkout flow
+- Comparison features
+- Reviews accessible
+- Wishlist/save for later
+
+**Key Patterns**:
+- Grid and list view toggle
+- Filter and sort
+- Product detail with gallery
+- Cart always accessible
+- One-tap purchase options
+
+**Reference Apps**: Amazon, Shopify apps, Booking.com
+
+---
+
+## Consistency Principles
+
+### Match Style to Subject Matter
+
+| App Purpose | Style Should Feel |
+|-------------|-------------------|
+| Utility | Efficient, invisible |
+| Finance | Trustworthy, secure |
+| Health | Supportive, calm |
+| Kids | Safe, fun |
+| Social | Expressive, personal |
+| Productivity | Focused, powerful |
+| Shopping | Exciting, trustworthy |
+
+### Internal Consistency Rules
+
+| Rule | Implementation |
+|------|----------------|
+| Same icon style | All outlined OR all filled |
+| Consistent color meaning | Red = destructive, Green = success |
+| Uniform spacing | Use 8dp grid |
+| Predictable interaction | Same gesture = same result |
+| Typography system | Use M3 type scale |
+
+## Anti-Patterns: Style Mismatch
+
+| Mismatch | Problem |
+|----------|---------|
+| Playful colors in banking app | Undermines trust |
+| Complex gestures in kids app | Frustrates young users |
+| Cluttered UI in wellness app | Defeats calming purpose |
+| Boring visuals in entertainment | Fails to engage |
+| Aggressive CTAs in health app | Feels manipulative |
+| Childish design in professional tool | Lacks credibility |
+| Dense information in casual app | Overwhelms users |
+
+## Implementation Checklist
+
+- [ ] Identified app category and target audience
+- [ ] Selected appropriate style profile
+- [ ] Color palette matches style
+- [ ] Typography matches style
+- [ ] Interaction patterns match style
+- [ ] Touch targets appropriate for audience
+- [ ] Animation style consistent
+- [ ] Internal consistency maintained
+- [ ] No style mismatches
+- [ ] Tested with target users

package/skills/android-native-dev/references/functional-requirements.md

@@ -0,0 +1,229 @@
+# Functional Requirements
+
+Audio, video, notifications, and other functional behavior requirements.
+
+## Audio
+
+### Playback Initialization
+
+| Requirement | Specification |
+|-------------|---------------|
+| Response time | < 1 second |
+| If delayed | Show visual progress indicator |
+| User feedback | Immediate acknowledgment of action |
+
+### Audio Focus Rules
+
+| Event | Required Action |
+|-------|-----------------|
+| Another app requests focus | Pause or reduce volume |
+| Focus regained | Resume or restore volume |
+| Playback stops | Abandon focus |
+
+### Audio Focus Handling
+
+| Focus Change | Action |
+|--------------|--------|
+| AUDIOFOCUS_LOSS | Stop playback |
+| AUDIOFOCUS_LOSS_TRANSIENT | Pause playback |
+| AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK | Reduce volume |
+| AUDIOFOCUS_GAIN | Resume playback |
+
+### Background Playback
+
+| Requirement | Implementation |
+|-------------|----------------|
+| Continue when backgrounded | Use Foreground Service |
+| Notification | MediaStyle notification required |
+| Media controls | System media controls integration |
+| Session | MediaSession for system integration |
+
+## Video
+
+### Picture-in-Picture (PiP)
+
+| Requirement | Specification |
+|-------------|---------------|
+| Video apps | Should support PiP |
+| Aspect ratio | 16:9 to 2.39:1 |
+| Auto-enter | When user navigates away during playback |
+
+### Video Encoding
+
+| Standard | Requirement |
+|----------|-------------|
+| Compression | HEVC (H.265) recommended |
+| Fallback | H.264 for compatibility |
+| Quality | Adaptive based on network |
+
+### Video Player Requirements
+
+| Feature | Implementation |
+|---------|----------------|
+| Fullscreen | Support landscape |
+| Controls | Play, pause, seek, volume |
+| Captions | Support closed captions |
+| Resume | Remember playback position |
+
+## Notifications
+
+### Channel Best Practices
+
+| Practice | Reason |
+|----------|--------|
+| Multiple channels | User can control each type |
+| Descriptive names | User understands purpose |
+| Appropriate importance | Match user expectation |
+| Don't share channels | Different content = different channel |
+
+### Notification Priority
+
+| Importance | Usage |
+|------------|-------|
+| HIGH | Time-sensitive (messages, calls) |
+| DEFAULT | Normal notifications |
+| LOW | Background info |
+| MIN | Minimal interruption |
+
+### Notification Content Rules
+
+| Do | Don't |
+|-----|-------|
+| Relevant information | Cross-promotion |
+| Clear, concise text | Advertising other products |
+| Actionable content | Unnecessary interruptions |
+| Set timeouts | Persistent non-ongoing notifications |
+
+### Messaging Apps Requirements
+
+| Feature | Description |
+|---------|-------------|
+| MessagingStyle | Use for conversation notifications |
+| Direct reply | Support inline reply action |
+| Conversation shortcuts | Enable direct share |
+| Bubbles | Support floating conversations |
+
+### Notification Grouping
+
+Group related notifications together with a summary notification. Set appropriate group keys and summary flags.
+
+## Sharing
+
+### Android Sharesheet
+
+Use the system sharesheet for sharing content. Create an ACTION_SEND intent with appropriate type and extras, then use createChooser().
+
+### Direct Share
+
+Provide conversation shortcuts for Direct Share ranking:
+- Create ShortcutInfo for each conversation
+- Set appropriate categories
+- Push dynamic shortcuts
+
+## Background Services
+
+### Service Restrictions
+
+| Rule | Implementation |
+|------|----------------|
+| Avoid long-running services | Use WorkManager |
+| No background starts (API 26+) | Use foreground service or JobScheduler |
+| Battery-efficient | Batch work, respect Doze |
+
+### Poor Background Service Uses
+
+| Don't Use For | Alternative |
+|---------------|-------------|
+| Maintaining network connection | FCM (push notifications) |
+| Persistent Bluetooth | Companion device manager |
+| Keeping GPS on | Geofencing, fused location |
+| Polling server | FCM or WorkManager |
+
+## State Management
+
+### State Preservation Requirements
+
+| Scenario | Required Behavior |
+|----------|-------------------|
+| App switcher return | Exact previous state |
+| Device wake | Exact previous state |
+| Process death | Restore critical state |
+| Configuration change | Seamless transition |
+
+### State Categories
+
+| State Type | Storage |
+|------------|---------|
+| UI state (scroll, selection) | ViewModel + SavedState |
+| User input (forms) | SavedState |
+| Navigation | NavController state |
+| Persistent data | Room database |
+
+## Navigation
+
+### Back Button/Gesture
+
+| Requirement | Implementation |
+|-------------|----------------|
+| System back | Navigate to previous screen |
+| Gesture navigation | Support back gesture |
+| No custom back buttons | Use system navigation |
+| Predictable | User knows what back does |
+
+## Gestures
+
+### Gesture Navigation Support
+
+| Gesture | Default Action |
+|---------|----------------|
+| Swipe from left edge | Back |
+| Swipe up from bottom | Home |
+| Swipe up and hold | Recent apps |
+
+### Custom Gestures
+
+| Practice | Reason |
+|----------|--------|
+| Avoid edge swipes | Conflicts with navigation |
+| Provide alternatives | Not all users gesture-capable |
+| Test with gesture nav | Ensure no conflicts |
+
+Handle system gesture insets to avoid conflicts with edge gestures.
+
+## Functional Checklist
+
+### Audio
+- [ ] Playback starts within 1 second
+- [ ] Audio focus requested and released
+- [ ] Responds to focus changes (duck/pause)
+- [ ] Background playback with notification
+- [ ] MediaSession integration
+
+### Video
+- [ ] Picture-in-picture supported
+- [ ] HEVC encoding used
+- [ ] Playback position remembered
+- [ ] Captions supported
+
+### Notifications
+- [ ] Appropriate channels defined
+- [ ] Correct importance levels
+- [ ] No promotional content
+- [ ] Grouped when appropriate
+- [ ] Timeouts set where applicable
+
+### Messaging (if applicable)
+- [ ] MessagingStyle used
+- [ ] Direct reply supported
+- [ ] Conversation shortcuts
+- [ ] Bubbles supported
+
+### Background
+- [ ] WorkManager for background work
+- [ ] No long-running services
+- [ ] Battery-efficient design
+
+### Navigation
+- [ ] Standard back behavior
+- [ ] Gesture navigation supported
+- [ ] State preserved across lifecycle