Skip to content

quietform/Luego

Repository files navigation

Luego

A minimal, offline read-it-later iOS app. I've built this app as an alternative to Pocket.

Download on the App Store or Join Beta on TestFlight.

## Architecture

Luego follows an opinionated Clean Architecture implementation organized by feature. See ARCHITECTURE.md.

Features

  • Quick Article Saving: Save articles via URL or iOS Share Extension
  • Automatic Metadata Extraction: Fetch titles, descriptions, and images automatically via OpenGraph tags
  • Offline Reading: Access saved articles with last read position
  • Clean Reader View: Distraction-free reading experience with Markdown rendering
  • SwiftData Integration: Modern data persistence with SwiftData

Requirements

  • iOS 26.0+
  • Xcode 26.0+
  • Swift 5.0+

Installation

1. Clone the Repository

git clone https://github.com/quietform/Luego.git
cd luego

2. Open in Xcode

open Luego.xcodeproj

3. Configure Signing

Before building, you need to configure code signing:

  1. Select the Luego project in the navigator
  2. Select the Luego target
  3. Go to Signing & Capabilities tab
  4. Select your Team from the dropdown
  5. Repeat for the LuegoShareExtension target if needed

The bundle identifier can be changed to your own if desired.

Developer CLI

Use xcodebuildmcp instead of calling xcodebuild directly. This repo configures the project path, scheme, Debug configuration, and default iPhone simulator in .xcodebuildmcp/config.yaml.

xcodebuildmcp simulator build --use-latest-os
xcodebuildmcp simulator build-and-run --use-latest-os
xcodebuildmcp simulator test --use-latest-os
xcodebuildmcp simulator list
xcodebuildmcp simulator screenshot --simulator-id <uuid>
xcodebuildmcp simulator snapshot-ui --simulator-id <uuid>