Postmarks is a bookmarking site that you own yourself and can connect the Fediverse, interacting with other Postmarks sites as well as Mastodon/FireFish/any text-based ActivityPub platform. You can read more about it here:
The site allows the owner to add, edit and delete bookmarks, but only if a valid login is provided. Check the setup below to understand how to do that!
To set your app up:
- If you're using Glitch:
- Rename your project immediately in the project settings, if you intend to be called something else. This determines the domain that your site lives at, which also determines the second half of your
@[email protected]
identity on the fediverse. NOTE: If you change this later, you will break the connection any existing followers have to your site, they'll have to re-follow the account on its new domain (and depending on the software they're following from, may even prevent them from unfollowing the old URL ๐ฑ) - In your
.env
editor, create a keyADMIN_KEY
and give it a text string as a value. This is your "password" when your browser prompts you, so make it as secure as you need to protect your data. - Add another key to your .env called
SESSION_SECRET
and generate a random string for its value. This is your session secret, used to generate the hashed version of your session that gets encoded with the cookies used to store your login. If you make this string too easily guessable, you make it easier for someone to hijack your session and gain unauthorized login. Also, if you ever change this string, it will invalidate all existing cookies. - If you've got a custom domain in front of your Glitch project, add a key to your .env called
PUBLIC_BASE_URL
with the value set to the hostname (the part after the https://) at which you want the project to be accessible. - Edit the contents of
account.json.example
to set your@username
, display name, bio, and avatar. (If you don't set a username, your default actor name will be 'bookmarks', so people will find you on the fediverse@[email protected]
.) - THEN: either rename
account.json.example
toaccount.json
, or copy the contents into a new file calledaccount.json
. Whateverusername
you have in this file when the project first starts you'll need to retain or else you'll break your followers' connection to this account.
- Rename your project immediately in the project settings, if you intend to be called something else. This determines the domain that your site lives at, which also determines the second half of your
- Otherwise:
- Create a
.env
file in the root of the project. - Add the line
PUBLIC_BASE_URL=<hostname>
to your .env where <hostname> is the hostname of your instance. - Add the line
ADMIN_KEY=<key>
to your .env where <key> is the password you'll enter when the browser prompts you, and another line forSESSION_SECRET=<secret>
where <secret> is a random string used when hashing your session for use in a secure cookie. - Make a file called
account.json
in the project root. Copy the contents ofaccount.json.example
into it and edit the values to set your@username
, display name, bio, and avatar. (If you don't set a username, your default actor name will be 'bookmarks', so people will find you on the fediverse@[email protected]
.)
- Create a
- If you're using Glitch, you should be done! If you're running this yourself, run
npm run start
via whatever mechanism you choose to use to host this website. - Click on the Admin link in the footer, and enter the password (whatever you set ADMIN_KEY to in the .env).
- You should be logged in, at which point you can configure various settings, import bookmarks, and use the "Add" links in the header and footer (as well as the bookmarklet, available in the Admin section) to save new bookmarks.
Setting MASTODON_ACCOUNT
in the .env
file will cause a link to be added to the Postmarks home page that can be used for verification with your Mastodon account. See the Mastodon documentation for more details.
- To automatically log all requests to a text file, set add
LOGGING_ENABLED=true
to your .env file. This will cause all incoming requests to append torequest_log.txt
in your project folder.
- The "Postmarks" name is compliments of Casey C (no relation to Casey K), who brainstormed dozens of ideas for the name when Casey was first trying to rename the project. Thank you!
- Postmarks (in its default configuration) uses an edited version of Eynav Raphael's "Postmark Stamp" icon from The Noun Project.
- It also makes use of free fonts including Averia Sans and Public Sans.
- Much of the original form of the site's frontend is lifted from the starter projects available on Glitch. Thank you to all the people who have contributed to those projects over the years!
- Much of the original backend of the site is based off of Darius Kazemi's express-activitypub repo. I made a point not to just clone his repo from the start, but then ended up retyping most of it as I learned how things work. While some pieces have been upgraded, much of Darius' work creates the foundation for Postmarks' ActivityPub functionality.
Glitch is a friendly community where millions of people come together to build web apps and websites.
- Need more help? Check out the Help Center for answers to any common questions.
- Ready to make it official? Become a paid Glitch member to boost your app with private sharing, more storage and memory, domains and more.