Rolodex

This browser extension lets you download a social network contact as a vcard file. The vcard file can then be quickly imported to you phone's contact list.

My motivation for building this was a realization that our social network services are simply middlemen which can be skipped. By curating a contact list on our phone we can quickly get in touch with new and old acquaintances. This won't help you become an influencer on social media but it'll let you be social without any gatekeeping middlemen pelting you with ads or re-selling your data.

Features per Social Network Service (SNS)

• linkedin.com: The vCard file will include name, photo, title, url (linkedin profile), pronouns (if defined). Please note that user email will not be included so you'll have to ask your contact for that separately.

We can certainly support other networks in the future. See next paragraph.

Feedback and/or development sponsorship

Send an email if you have feedback, want to contribute and/or want to sponsor future development.

Getting started with developing

Prerequisite(s): Node.js, and the browsers you want to test against.

1. Run npm install, this will install some useful tools for having livereload support while developing.
2. Run tests using npm test or npm run test:watch
3. For rapid development you can run one or more of these commands:
   • npm run dev:ff for Firefox. Note: On initial setup you'll need to create a profile beforehand named rolodex-extension-sandbox. Inside your Firefox go to the url about:profiles and create your profile there.
   • npm run dev:android to debug your extension on Firefox for Android. It's really effective but a little fiddly to setup, check out the setup guide here.
   • npm run dev:chrome for testing against Chromium.
   • npm run dev:html if you want to work solely on the extension's html popup.

The package.json file has all available commands.

Tip: Firefox has a really cool site with info on how to build extensions. Be sure to check out their developer tools.

Development philosophy

• Minimize dependencies
• Minimize required permissions
• Minimize build steps
• Do not use any AI (my reasoning)

Related reading

• https://en.wikipedia.org/wiki/VCard
• https://www.rfc-editor.org/rfc/rfc6350
• https://evertpot.com/escaping-in-vcards-and-icalendar/

Licensing

This project uses REUSE Software for licensing.

See LICENSES/ to see what licenses are used for this project. See the top section of individual files to learn what license they're released under, for the most part they're released under the Hippocratic 3.0 license. Consult the actual license text within the LICENSES/ directory for full details. See also the REUSE.toml file(s) to review licensing for files that don't support custom headers (such as image files).

To generate a complete Software Bill of Materials (SBOM), you can run the terminal command reuse spdx (requires the reuse tool).