LinkFree, open-source alternative to LinkTree

December 07, 2022

Linktree is a tool that allows you to gather many links in a single page that you can share so that people can find all your links in one place. The free plan offers unlimited links and a customizable profile to share but all the interesting features don't come for free.

EddieHub, a Community of inclusive Open Source people, worked on a free alternative to Linktree, LinkFree. Here's how I created my profile.

Development environment setup

First of all, fork the LinkFree repository and clone it on your machine.

Now download and install Docker, you will need it to run the MongoDB database. Once installed, you can login into your Docker account.

Make sure to have node v18.12.1 and npm v8.19.2 before installing the dependencies in the repository. I use nvm to easily switch between different NodeJS versions.

Finally, navigate to the repository root folder and start up the project

cd my/path/LinkFree
npm install
docker-compose up

Check Docker to verify the container is up and running.

Docker container status

The last command starts up Docker MongoDB image. LinkFree provides a great quickstart guide in its README.

Create your profile page

Creating your profile page is very easy. Open your forked repository in a code editor and add a JSON file in the ./data folder, for example rossanodan.json. Here you can see mine. There is a detailed guide on how to add your profile on the README of LinkFree.

Launch the app locally with npm start and open it in your browser. Search for your name and there it is! Your profile is ready!

Your profile is ready!

Push your changes

Now you can stage the changes - make sure to follow the contribution guidelines - commit and push. Finally create a pull request in LinkFree and wait it gets reviewed by the maintainers.

Easy, right? Here is my LinkFree profile https://linkfree.eddiehub.io/rossanodan.

A special thanks to Eddie Jaoude and the EddieHub Community for creating this great tool. If you wish to get involved, reach them out on the Community Discord server.


Profile picture

Written by Rossano D'Angelo. Software engineer in the United Kingdom. When I don't write code, I read comic books and manga. Follow me on Twitter.