Skip to content

haneenmahd/linked

Repository files navigation

Linked

A beautiful and simple template to display all your social links 🔗 but from a dev's perspective.


Linked-Thumbnail

Usage 📕

In-order to install this template, you might need to clone this repo using git.

git clone https://github.com/haneenmahd/linked.git

After cloning the repo. You would need to configure your custom links, titles and names. But, we have a script to get you started. Exeucte the following in a terminal:

yarn configure

## Enter your name and other more stuff

Read Configuring to know more about how-to configure your data.

Configuring 🛠

After running yarn configure, you will be prompted by a set of questions. Well, this section provides documentation to those stuff 🙂.

  • Name: Provide your name or the Title you would like to see
  • Description: Simply describe yourself 😃!
  • ShadowType: this is optional, but your avatar would look great if you apply some shadow to it. Use soft-shadow to apply a soft one. You can also use violet-gradient, green-gradient, reflection -> slightly reflects your avatar to the bottom.
  • Animated Shadow: animate the shadow of your avatar. provide y for yes, n for no. The default value is yes.
  • Paypal Username: Share your Paypal username that will be used to display Paypal link

Configuring using src/data/config.json

Here is the sample json file

{
  "avatarOptions": {
    "title": "Your name",
    "description": "Describe yourself :D"
  },
  "stylingOptions": {
    "shadowType": 3,
    "isShadowAnimated": true
  },
  "links": [
    {
      "linkUrl": "https://github.com/haneenmahd",
      "placeholder": "GitHub",
      "colorSet": 0
    },
    {
      "linkUrl": "https://dribbble.com/haneenmahdin",
      "placeholder": "Dribbble",
      "colorSet": 1
    },
    {
      "linkUrl": "https://twitter.com/HaneenMahdin",
      "placeholder": "Twitter",
      "colorSet": 4
    },
    {
      "linkUrl": "mailto:haneenmahdin@gmail.com",
      "placeholder": "Mail me ✉️",
      "colorSet": 2
    },
    {
      "payPalConfig": {
        "payPalUserName": "",
        "text": "Paypal me 💸"
      }
    }
  ]
}
  • avatarOptions contains configurations about the page.

  • stylingOptions is used to style the avatar image. It accepts two objects

  • shadowType: a number representing a specific shadow type

    • 0 - Uses reflection
    • 1 - Uses violet gradient shadow
    • 2 - Uses green gradient shadow
    • 3 - Uses soft-shadow
  • links object accepts a arrays of LinkConfig (configuration used to create links inside the website)

    • link object
      • linkUrl: url to a specific link
      • placeholder: placeholder text
      • colorSet: link's background and foreground theme
        • 0: GitHub theme, used specifically to showcase GitHub portfolio.
        • 1 - Dribbble theme, used to showcase dribbble portfolio
        • 2 - Portfolio theme, an old-school design
        • 3 - Instagram theme, showcase instagram profile
        • 4 - Showcase twitter profile If you want to provide paypal link inside this object, you can use these properties instead.
        • payPalConfig: Configurations for PayPal link component
          • payPalUserName: Your paypal user name
          • text: Placeholder text of the link

Questions 🤔

  • How to setup your custom avatar Instead of the default one?

    The answer is simple, the component fetches the image from /src/assets/png/avatar.png. You can move your image file into that specific path.

Any other questions? Discussions are open ✉️

License and Legal Usage 🧑‍⚖️

This project is free to use and can be edited to create an alternative one. But the credit to the original creation is still left with @haneenmahd.

Licensed Under MIT

About

A beautiful and elegant template for building your link tree

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •