How to vibe codeGoodLinks

Prerequisites

• 

  Mac

  Required for building iOS and macOS native applications using Xcode.

• XcodeFree

  Official IDE for Swift, SwiftUI development, and compiling native Apple platform extensions.

• 

  Apple Developer Account$99/yr

  Required for configuring CloudKit containers and provisioning native system extensions on physical devices.

AI coding tools

• Claude Code

  Agentic terminal coding tool capable of scaffolding Swift data models, view hierarchies, and parsing logic iteratively.

• 

  Cursor

  Ideal AI-native editor for inspecting SwiftUI layout diffs and tweaking UI components visually.

Build guide

1. 01Project Scaffolding & SwiftData Local Schema

   Initialize a multiplatform iOS and macOS SwiftUI app container using Xcode, configuring SwiftData models for Articles, Highlights, Notes, and Tags.

   Create a multiplatform Swift/SwiftUI app skeleton targeting iOS 16+ and macOS 13+. Set up SwiftData models for `Article` (id, url, title, author, contentHtml, plainTextContent, excerpt, publishedDate, addedDate, readingPosition, isStarred, isArchived, tags), `Highlight` (id, articleId, text, note, color, createdAt), and `Tag` (id, name). Configure the App entry point to initialize the SwiftData model container with CloudKit synchronization enabled using a shared iCloud container identifier.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

2. 02Article Readability Extraction Pipeline

   Implement a local or extension-based HTML parsing service using SwiftSoup to clean web DOMs, stripping advertisements, scripts, and navigation clutter.

   Implement an article extraction utility in Swift using SwiftSoup. Write a function that takes a raw HTML string from a URL fetch, strips out script tags, styles, ads, navbars, and footers, and extracts the primary semantic container and article title. Clean the resulting HTML to render inside a customizable SwiftUI WebView or text view with adjustable font size, line spacing, and theme colors (Light, Sepia, Dark, Night).

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

3. 03Reader UI & Highlighting Engine

   Build the immersive reading view supporting text selection, color-coded highlights, and attached user notes.

   Build a SwiftUI Reader View for articles that renders clean HTML or attributed text. Implement text selection handling that allows users to tap selected text and trigger a floating menu to add a highlight with customizable colors (yellow, green, blue, pink, purple) and attach optional Markdown-compatible text notes. Store these highlights in SwiftData linked to the parent article entity and display them in a unified Notebook sidebar view.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

4. 04Share Sheet and Safari Extensions

   Create native Share Sheet and Safari Web Extensions to capture web pages directly into the app from any browser or app.

   Add a macOS/iOS Share Extension target to the project. Implement an extension view controller or SwiftUI view that parses incoming URLs and page metadata from the system share sheet, extracts the article content, and inserts a new `Article` record directly into the shared App Group container so the main application accesses it instantly via SwiftData/CloudKit.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

5. 05Organization, Search, and Markdown Export

   Implement full-text search across article attributes, tag management, and customizable Markdown export functionality.

   Add full-text search capabilities across article titles, authors, descriptions, and extracted content using SwiftData predicates. Build a tag management interface to filter articles by tags and starred status. Implement a Markdown export service that formats article metadata, highlights, and notes into customized Markdown templates for copying to the clipboard or sharing to external apps like Obsidian.

   ⧉copy promptopen in Claude CodeCopen in Codexopen in Cursor

Cost vs paying for GoodLinks