General

Developers

Legal

FAQ

Welcome to the FAQ page. You will have fun here.

What is Pinefore?

Pinefore's goal is to help users collect content that's popular on other sites, and discover more content they might like. It facilitates this in a number of ways, like

  • Bookmarking
  • RSS Feeds
  • Community features
  • Recommendation engines
  • Experiments

Plus more coming very soon:

  • Search
  • Funding Platform
  • Annotation
  • ActivityPub integration

We are adding another layer to the browser, a layer that brings you closer to the content you consume. We envision the web as a creative, connected and passionate space, a space that places the spirit of curiosity and discovery above mindless consumption.

First, unlike other services, it is in our best interest to make you happy. If you are not happy, you will stop sending us money, and that would not be good for businesses. Comparatively, most social sites have perverse incentives to keep you on their site, so that they can display more ads to you. Technically, it is in my best interest to keep you away from my site, to reduce costs. Luckily, the costs per user are low, but the point remains: I want you to get the things you are looking for as fast as possible.

If you're wondering how Pinefore compares to software like Reddit, Lemmy and Hacker News, it all comes down to catagorization. These services are "link aggregators". People submit content to these sites that they expect other readers will enjoy. Your home page is curated by others. You are discouraged from submitting content that you are interested in, but the rest of the community isn't. This can be a good thing, but this is not how Pinefore works. Pinefore puts the preferences and curation of you front and center. Ranking algorithms for community features on Pinefore work best when people do their own thing — completely oblivious to the larger world. Pinefore is your home, and link aggregators are times square.

If you are familiar with del.icio.us (or pinboard), you will be familar with Pinefore.

Speaking of Pinboard, the main difference between us is the number of auxiliary features offered. Pinboard is largely regarded as "complete" by its author. This is wonderful, there incredible merrit to completed software. Many pinboard users are very happy with the service, and I share a number of philosophical similarities to its author. By contrast, Pinefore is new. It is growing. It is actively getting better. It aims to be what Pinboard would have been if it was written in 2024.

Does Pinefore use AI?

Under the Terms of Service, using our data to train generative AI is not allowed. Pinefore attempts to downrank content that is produced with generative AI, mostly through user flagging (I have not been able to detect it with accuracy reliable enough to do it automatically).

Pinefore currently uses generative AI in the following locations:

  • To automatically generate titles for certain content that does not have one.

Pinefore does not currently make use of machine learning in its recommendation engine.

Pinefore has a particular interest in building a strong reccomendations system. We're lucky enough to have strong user heuristics by nature of the tag system. In the future, I'm interested in using an embeddings model to supercharge content reccomendations and search, so we can answer questions like "What articles are related to this?" in a technique similar to what is described here. More importantly, I'm interested to see just how far I can get without doing embeddings, which are expensive. Especially as the entire system is already built on user tagging, which negates embeddings significantly.

Economics

They were bound to come up eventually

How much does this thing cost?

Instead of your data, this thing costs money. Our pricing is incredibly easy to understand. You pay us $24 a year. If you are worried by the fact that 50% of the web rots in 10 years, and you want us to download everything you save to our servers automatically, you can pay $12 additional dollars a year for Pinefore Archive.

If you don't speak American, the pricing will be localized. If you cannot afford Pinefore for any reason, you can reach out to me and propose a price. I will try to accommodate you.

Is there a trial?

A lot of the site can be used without logging in. In addition, there is a trial for up to 7 days.

Pinefore costs $24 USD. We hope it will be worth it to you. This relationship keeps our incentives focused on you. We don't need to worry about losses from our free tier, or conversions.

Who is funding you?

You. Pinefore does not have investors. Pinefore can be profitable at only 3 users, and we have more than that. This means we are winning the startup game, as far as I'm concerned.

How do you plan to fund the internet?

While Pinefore is owned by me at Toastcat LLC, it operates like a B Corp. Once Pinefore makes sufficient enough income to sustain me, a portion of revenue will be used to sustain the web. How will this work?

  1. Human made donations to top websites from a handcrafted pool.
  2. Eventually, a portion of subscriptions will be allocated to creators by view time, à la Coil.
  3. Eventually, an add-on subscription will be offered so users can increase their contributions.
  4. Maybe eventually, writing grants will be offered to those getting a foothold in the indieweb.
  5. Maybe maybe eventually, I will offer contract work on features to the community.

Features

Feedfore

  • Feedfore supports unlimitedish feeds per account.
  • The retention period of the feed is derived from complex server politics, but it basically comes down to how beloved the feed is, and how active it is. For instance, a little used feed that posts 10 times a day would only be saved for 6 months, a feed like the NYT might last a little longer despite having 25 posts a day, and a blog like idle words would last, in effect, forever. Supply and demand baby! Its important to note that these retention policies are weighted heavily against chronic posters. If you follow mostly independent content, that content will likely last for a very very long time. This policy is mostly in place to avoid saving, say, the 15 million articles in NYT. In practice, retention periods vary between infinity years to 6 months.
  • Feeds sometimes may be impressively backfilled. This could be because of two things:
    • A "pool"
    • Archive.org
  • Feeds using HTTP authentication do not contribute to the pool.
  • Pinned items are saved forever. They may or may not contribute to the retention period (when I say server politics are complicated, I really mean that).

Archival

  • Pinefore's archival service basically just falls under the reasonable use TOS.
  • Pinefore's archival may have some magic.
    • The archive may be disabled on sites where the magic doesn't work.
  • Per site, we save a maximum of 50mb of content.
  • You may see content in the archive that is older than it appears for you. If this is the case, you can choose to "resave it".

Sovereignty

Do you have an API? Do you like standards?

I'm glad you asked because I do like standards. Pinefore supports the following APIs:

  1. Delicious/Pinboard pinefore.com/api/pinboard/v1/
  2. The Google Reader API at pinefore.com/api/greader/ with some of its extentions. A normal app using the Google Reader API should be fine.
    1. While, for compatibility, we use X-BQ-LoginErrorReason as well, you should really be looking at the status. A 402 indicates payment is required.
  3. The Fever API at pinefore.com/api/fever/.

If your client only takes a domain and gets messed up by the fact that the prefixes are non-standard, you will soon be able to use the following proxies: pinboardapi.pinefore.com, greaderapi.pinefore.com, feverapi.pinefore.com. (These proxies do not work right now. If you need them reach out to me below). One current limitation of the compatibility layer is that errors can be non-standard in some cases.

Feedlog can follow RSS feeds. You can follow the RSS feeds of Pinefore users by adding .rss to the end of the URL.

In some cases, we offer supersets on top of these APIs to support our additional features. Unfortunately these supersets are not currently documented.

See /api/doc for documentation.

Does this work offline?

Yes, a lot of the personal aspects of the site work offline. By default, the extension will save your last 1000 bookmarks. This will take less than a megabyte. You can change this number in settings. CUD operations will happen on your client and then sync to the server. Note that the conflict resolution algorithm isn't great so if you change the same item on two devices, the most recently changed version will win.

How private is Pinefore?

I am not in the business of selling your data. Pinefore is a social service, however. You can make individual pins private, and make them private by default.

Can I export my data?

Yes you can. And it will happen fast. Like it goes into a queue immediately. It goes fast enough that you don't need to leave the page. If you do leave the page, we will email it to you. Actually, we will email it to you regardless.

Does Pinefore work without JavaScript?

Pinefore is designed in a way condusive to progressive enhancement — a little work will go a long way in this department. Beyond SSR, however, we have not yet made a concerted effort to make the site work without JavaScript.

What JavaScript does this use?

The actual JavaScript that is shipped to the client predominantly consists of Solid.js — a lightweight library for reactive apps, and Kobalte — a UI library that handles accessibility. In payment flows, Paddle.js is also loaded.

What if you get hit by a bus

I might die.

is Pinefore Open Source

Pinefore can be divided into 4 components:

  • The Frontend
  • The Backend
  • The Extension
  • The Apps

The apps and the extension are both open source. The frontend & backend are developed in a monorepo, and that monorepo is about 25% open source. The open source components includes most middleware and helper functions. The closed source code is mostly the "glue" between these interesting pieces (eg. the router, the database). We are ultimately running a business, and we intend to offer paying customers the very best. The success of the business allows me to devote more time to the project, and more money to the indieweb. By open sourcing the more interesting parts, we intend to foster a community of "competitors" on the fediverse, that offer different takes on this problem. In other words, instead of a homogenous cluster of instances, we want many unique varients.

How can I talk to you?

One of the founding philosophies is that talking to customers is the best way to make your product great. I really really really want to talk to you, so if you email me I will respond. Send me feature ideas, bugs, painpoints, love, memes, really anything. I'll respond.

Because robots ruined the internet: My name is Evan Boehs. My email is (my first name)@(my last name).org

Also, if I send you an email asking for feedback, I actually sent that email myself. Its not automated or anything. I genuinely want to hear from you.