• LinkFree connects audiences to all of your content with just one link. It is an open-source alternative to Linktree implemented in JavaScript.
• It was initially created on a YouTube live stream.

Check out the website: https://linkfree.eddiehub.io

Before contributing or adding a new feature, please make sure you have already installed the following tools:

• Git
• NodeJs

1. Fork the project
2. Clone the project
3. Navigate to the project directory cd LinkFree
4. Install dependencies with npm install
5. Run npm start
6. Optional: Run the tests with npm run cypress:run

Warning: After adding your profile, you'll not see it on the home page; you can see your profile in the main menu by running the command npm run generate.

Alternatively, skip all the steps by using

• Contributions make the open source community such an amazing place to learn, inspire, and create.
• Any contributions you make are truly appreciated.
• Check out our contribution guidelines for more information.

Create a file named using your GitHub username username.json in the directory public/data, this will ensure it is unique.

Optional fields: links, milestones and type(personal | community)
Looking for inspiration? You can view the following profiles for an example:

• Eddie Jaoude
• Naomi Carrigan
• Kaiwalya Koparkar

Your brand new file should look something similar to this one: (note: add/remove links objects to customise your profile, milestones are optional)

{
  "name": "YOUR NAME",
  "type": "personal",
  "bio": "Open Source Enthusiast!",
  "avatar": "https://github.com/YOUR_GITHUB_USERNAME.png",
  "links": [
    {
      "name": "Follow me on GitHub",
      "url": "https://github.com/YOUR_GITHUB_USERNAME",
      "icon": "github"
    },
    {
      "name": "Follow me on Twitter",
      "url": "https://twitter.com/YOUR_TWITTER_USERNAME",
      "icon": "twitter"
    }
  ],
  "milestones": [
    {
      "title": "Started Freelancing",
      "date": "December 2021",
      "icon": "dollar",
      "color": "grey",
      "description": "Started freelancing",
      "url": "https://www.eddiejaoude.io/"
    }
  ]
}

Your URL will be https://linkfree.eddiehub.io/<yourusername>

For example: https://linkfree.eddiehub.io/eddiejaoude

To include your avatar, You just have to replace <yourusername> with your github username in the format of https://github.com/<yourusername>.png and it will automatically be fetched from github account.

For example: http://github.com/eddiejaoude.png

Note: after your PR is merged, the project still needs to be deployed for your profile to be displayed

Check Icons.md for all the supported icons.

If you wish to self-host this app for a single user, follow the same steps as above, but then in the file src/config/user.json add your username.

For example

{
  "username": ""
}

LinkFree is licensed under the MIT License - see the LICENSE file for details.

Thanks a lot for spending your time helping LinkFree grow. Thanks a lot! Keep rocking 🍻

This project needs a ⭐️ from you. Don't forget to leave a star ⭐️