Skip to content
An open source Instapaper clone that features apps and extensions that use native UI Components for Mac and iOS.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Hipstapaper
.gitignore
LICENSE
README.md
readme-screenshot.png

README.md

Xcode: 9.3 Swift: 4.1 iOS: 11.0 macOS: 10.11 devices: iPhone & iPad & Mac

Hipstapaper Screenshots

Hipstapaper - iOS and Mac Reading List App

A native cross platform reading list app that I use for prototyping and learning.

How to Get the App

Hipstapaper is not available on the App Store. Its not broadly usable in its current state because it requires the user to provide their own Realm Object Server to start syncing. I use a TestFlight build to use the app on my own iOS devices and I have a developer signed and self-hosted binary for macOS.

Summary of Capabilities

  • All features implemented separately in UIKit and AppKit.
  • Add URL's into the application by using macOS and iOS system share sheet.
  • Perform Bulk CRUD and Tagging operations in the application.
  • Search, filter, and sort items in the application.
  • Syncronize list between devices using Ream Object Server
    • Realm Object server is user provided currently.
  • Restore application state

Why Did I Write This?

  • I wanted to learn how to make a Source-List / Splitview style app in both UIKit and AppKit.
  • I wanted to learn how to make a CRUD style application.
  • I wanted to learn how to provide search, filter, and sorting capabilities in an application.
  • I wanted to learn how to use Mac specific features like drag and drop, menus, contextual menus, etc.
  • I wanted to learn how to use Realm.
  • I wanted to learn how to use the Realm Object Server.
  • I wanted to learn how to make share extensions on macOS and iOS.

Contribution Guidelines

I'm so happy you're interested in contributing. However, I am not accepting any contributions to this project right now. I plan on replacing this app with a replacement where I want to learn some new concepts for the data management. When I start on that new project, I'll add a link here.

Top Issues

How to Clone and Run

Requirements

  • Xcode 9.3 or higher
  • Cocoapods

Instructions

  1. Clone the Repo:
    git clone 'https://github.com/jeffreybergier/Hipstapaper.git'
    
  2. Install Cocoapods
    cd Hipstapaper/Hipstapaper/
    pod install
    
  3. Change Team to your AppleID (needed to run on your physical device)
    1. Open Hipstapaper.xcworkspace in Xcode.
    2. Go through both macOS targets and both iOS targets and…
    3. Under Signing, change the team from its current setting to your AppleID.
  4. Build and Run
    • Hipstapaper works in the simulator and on physical devices
You can’t perform that action at this time.