Barnacles is an iOS app for reading barnacl.es, a link aggregator for small, self-funded businesses with the tagline “News for bootstrappers, not VC hackers”. The site was based on the code of Lobsters, the tech news site. The app lists the Top, Recent and All stories with their authors, tags and scores, loads more as you scroll, refreshes when you pull down, and opens a story’s link when you tap its title.
The app didn’t read barnacl.es directly. It was built over a week in May 2017 as three repositories:
- BarnaclesNative, the React Native app.
- BarnaclesApi, an Express server that scraped the site’s pages into JSON for the app.
- barnacles-scraper, a small npm package that wraps the API.
None of them has changed since. barnacl.es and the API’s host no longer exist, so the app has nothing left to load.
The app
Each tab is a route in React Router v4’s NativeRouter, and each route renders the same list component with a different endpoint: /top, /recent, or the front page for All. The tab bar is a row of NavLinks, and the one for the current route turns a darker teal.

The list fetches the first page of its endpoint from the API and shows a spinner until it arrives. React Native’s ListView renders the stories through react-native-infinite-scroll-view, which asks for the next page when you reach the bottom, and a RefreshControl reloads the first page. The views are styled components from styled-components/native: tomato-red titles, teal tag pills, an orange score badge and a few shadows.
The app uses React Native 0.44 with React 16.0.0-alpha.6, and it was only set up for iOS. Its Android entry point is still the template’s welcome screen, and the README lists the Android app as a to-do.
The API
BarnaclesApi is an Express 4 server that fetched barnacl.es pages with request, parsed them with Cheerio, and answered with JSON. It has routes for the front page, Top, Recent, a tag’s stories, the list of tags, a user’s profile and a story’s comments, with an optional page number where the site had pages. Links to profiles and comments in the JSON point back at the API itself, using an API_URL from a .env file. It’s written in ES2015 and built with Babel when it’s installed, and a Procfile starts it with npm run serve.

With barnacl.es gone, the API can still run against an archived copy of the site. Here it answers its front-page route from the Wayback Machine’s copy of barnacl.es from June 3, 2017:

The npm package
barnacles-scraper wraps the API in six functions that return promises: getTopStories, getRecentStories, getStories, getStoriesByFilter, getUser and getTags. Each is a node-fetch call to the API’s host. webpack 2 and Babel build it into one CommonJS file, and its Jasmine tests run in Chrome through Karma, with coverage from Istanbul. One test file calls the live API and expects 25 stories a page, a user profile and a web tag, and the rest check that each method exists. Version 0.1.0 went to npm on May 13, 2017, and it’s still listed there, though the API it calls is gone.
The creation date shown here is the GitHub repository’s UTC creation date. The app screenshots are crops of the screenshot in the BarnaclesNative README, the terminal capture comes from running BarnaclesApi locally against an archived copy of barnacl.es, and the code cards show the repositories’ source files.