LearningArticle

Learning tutorial or article for MyCuppa educational content

Schema

| Property | Type | Required | Description | |----------|------|----------|-------------| | id | string (uuid) | ✓ | Unique identifier for the article | | slug | string | ✓ | URL-friendly slug for the article | | title | string | ✓ | Article title | | summary | string | ✓ | Brief summary of the article | | content | string | ✓ | Full article content in markdown format | | author | string | | Article author name | | difficulty | enum | ✓ | Difficulty level | | topic | enum | ✓ | Article topic | | image_url | string (uri) | | URL to the article's featured image | | reading_time_minutes | integer | | Estimated reading time in minutes | | tags | string[] | | Tags associated with the article | | prerequisites | string[] | | Prerequisites for this tutorial | | learning_objectives | string[] | | What readers will learn | | is_bookmarked | boolean | | Whether the user has bookmarked this article | | progress | integer | | User's reading progress percentage | | published_at | string (date-time) | ✓ | When the article was published | | updated_at | string (date-time) | | When the article was last updated |

Example

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "slug": "getting-started-with-swiftui",
  "title": "Getting Started with SwiftUI",
  "summary": "Learn the fundamentals of SwiftUI and build your first iOS app interface.",
  "content": "# Getting Started with SwiftUI\n\nSwiftUI is Apple's modern declarative framework...",
  "author": "Jon Oxie",
  "difficulty": "beginner",
  "topic": "swiftui",
  "image_url": "https://mycuppa.io/images/tutorials/swiftui-intro.jpg",
  "reading_time_minutes": 15,
  "tags": [
    "swiftui",
    "ios",
    "beginner",
    "tutorial"
  ],
  "prerequisites": [
    "Basic Swift knowledge",
    "Xcode installed"
  ],
  "learning_objectives": [
    "Understand SwiftUI basics",
    "Create views",
    "Handle user input"
  ],
  "is_bookmarked": false,
  "progress": 0,
  "published_at": "2025-11-06T10:00:00Z",
  "updated_at": "2025-11-06T10:00:00Z"
}

Enums

difficulty

beginner | intermediate | advanced

topic

swiftui | uikit | architecture | testing | performance | security | design | general