suubh/LinkFree

Open source alternative to LinkTree

LinkFree - EddieHub

An open-source alternative to Linktree implemented in JavaScript - built by the EddieHub
Initially created on a YouTube live stream https://www.youtube.com/watch?v=Jorl_vcp-Ew

A note for Hacktoberfest Participants:

Pull requests which add or edit your information in a data/${yourname}.json file will NOT be counted for Hacktoberfest.

Pull requests which improve the codebase, documentation, or other aspects of the project and are in line with the core values of the event will be counted - maintainers will opt in these PRs by applying the hacktoberfest-accepted label.

Quickstart

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

Optionally 6. Run the tests with npm run cypress:run

Alternatively, skip all the steps by using the system.

How can I add my profile?

Create a file named your-username.json in the directory public/data with the following content:

Optional fields: links and milestones

{
  "name": "Eddie Jaoude",
  "bio": "Founder of EddieHub",
  "avatar": "https://github.com/eddiejaoude.png",
  "links": [
    {
      "name": "Follow me on GitHub",
      "url": "https://github.com/eddiejaoude",
      "icon": "github"
    },
    {
      "name": "Follow me on Twitter",
      "url": "https://twitter.com/eddiejaoude",
      "icon": "twitter"
    },
    {
      "name": "Learn more about Open Source on my YouTube channel",
      "url": "https://youtube.com/eddiejaoude",
      "icon": "youtube"
    }
  ],
  "milestones": [
    {
      "title": "Started Freelancing",
      "date": "May 2010",
      "icon": "dollar",
      "color": "grey",
      "description": "Started freelancing again",
      "url": "https://www.eddiejaoude.io/"
    },
    {
      "title": "Started YouTube",
      "image": "https://github.com/eddiejaoude.png",
      "date": "June 2019",
      "icon": "youtube",
      "color": "red",
      "description": "First real video",
      "url": "https://youtube.com/eddiejaoude"
    },
    {
      "title": "GitHub Star",
      "date": "2020",
      "icon": "github",
      "color": "green",
      "description": "Became a GitHub Star with 30 other people",
      "url": "https://github.com/eddiejaoude"
    },
    {
      "title": "GitHub Star of the Year",
      "date": "2020",
      "icon": "github",
      "color": "green",
      "description": "Won GitHub Star of the Year out of 55+ million people",
      "url": "https://github.com/eddiejaoude"
    }
  ]
}

Your URL will be http://linkfree.eddiehub.org/<yourusername>. For example: http://linkfree.eddiehub.org/eddiejaoude
Your avatar URL should take the format of https://github.com/<yourusername>.png.

Home page profiles

Your profile will automatically appear on the home page.