LinkFree is the Open Source alternative to LinkTree. A platform where people in tech can have a single hub to showcase their content in order to accelerate their career, whilst contributing to an Open Source project and being part of a community which has a say in where the project is going.
Your profile will have links to your social media and content. You can also add your timeline, testimonials and upcoming events that you are participating in.
Here is an example of a LinkFree Profile...
You have 4 options to contribute to the repo, please pick your favourite from:
- GitHub UI
- Gitpod
- Local development
- Local development with Docker Compose
Brief documentation below, but full documentation can be found here https://linkfree.eddiehub.io/docs
This is great if you only want to add your Profile or make changes to it.
note: give extra attention to json formatting and the GitHub Action after you create the Pull Request
In the cloud free development environment which will have all the dependencies you need (for example MongoDB).
You can use Gitpod in the cloud
This environment is fully on computer, and requires each dependency (for example MongoDB) to be installed and setup, but gives you the most flexiblity for customisation.
Before contributing or adding a new feature, please make sure you have already installed the following tools:
- NodeJs (Works with Node LTS version v16.17.0)
- MongoDB
- Optional NVM: Switch Node version by using
nvm use
(on Windows, usenvm use v16.17.0
). If this is not installed, runnvm install v16.17.0
.
You can set this up locally with the following steps:
- copy the
.env.example
file to.env
and update any details required - mongodb is required, it is possible to use
docker-compose up
to start the mongodb service npm install
npm run dev
Step by step quickstart guide can be found in the full docs here https://linkfree.eddiehub.io/docs/quickstart
- Fork the repository in your profile which lets you do the changes in the project without affecting the main repository
- Create a new branch
- In the
data
directory, create a.json
file with the same name as your GitHub username. For example, if your GitHub username iseddiehub
, create a file namededdiehub.json
. This will ensure that your username is unique.
Optional fields: milestones
, type(personal | community)
, socials
, testimonials
and events
Looking for inspiration? You can view the following profiles for an example:
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",
"displayStatsPublic": true,
"type": "personal",
"bio": "Open Source Enthusiast!",
"avatar": "https://github.com/YOUR_GITHUB_USERNAME.png",
"tags": ["javascript", "typescript"],
"socials": [
{ "icon": "twitter", "url": "https://twitter.com/YOUR_TWITTER_USERNAME" },
{ "icon": "github", "url": "https://github.com/YOUR_GITHUB_USERNAME" }
],
"links": [
{
"name": "Follow me on GitHub",
"url": "https://github.com/YOUR_GITHUB_USERNAME",
"icon": "FaGithub"
},
{
"name": "Follow me on Twitter",
"url": "https://twitter.com/YOUR_TWITTER_USERNAME",
"icon": "FaTwitter"
}
],
"milestones": [
{
"title": "Started Freelancing",
"date": "December 2021",
"icon": "FaDollarSign",
"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 have to replace <yourusername>
with your GitHub username in the format of https://github.com/<yourusername>.png
and it will automatically be fetched from your GitHub account.
For example: http://github.com/eddiejaoude.png
Note: After your PR gets merged, the project still needs to be deployed for your Profile to be displayed.
LinkFree is licensed under the MIT License - see the LICENSE file for details.
- Contributions make the open source community such an amazing place to learn, inspire, and create.
- Any contributions you make are truly appreciated.
Don't forget to leave a star ⭐️