Skip to content

amonsalv/AstroLink

Repository files navigation

Astro

AstroLink

Astro CSS3 JavaScript Netlify

Open source links page, customizable via JSON. Made with Astro 4.

AstroLinkHub Screenshot

Table of Contents

  1. About The Project
  2. Getting Started
  3. JSON
  4. Contributing
  5. License

About The Project

AstroLinkHub allows you to create a customizable links page for free, using your preferred colors and credits. Easily update it using JSON.

Back to top ⬆️

Getting Started

Prerequisites

  • Node.js -> v18.17.1 or v20.3.0 or higher. (v19 is not supported)
  • Visual Studio Code -> with the Official Astro Extension.

Personally I prefer using pnpm instead npm and to install it you can use:

npm install -g pnpm

Installation

  1. Clone this repo to your computer:
    git clone https://github.com/amonsalv/AstroLink.git
  2. Install Astro dependencies:
    cd AstroLinkHub
    pnpm install
  3. Run the Astro dev server:
    pnpm dev

Back to top ⬆️

JSON Configuration

The best part of AstroLinkHub is that you can modify every aspect of the website very easily, you just have to edit the index.json file. This JSON contains the following sections:

  • html -> Edit language, title, description and favicon (replace it in /public).
  • background -> Use the same color twice for a solid color or use two colors for a gradient color.
  • header -> Edit your image (replace it in /public), name and description.
  • socials -> Add more icons with your socials URL (see the networks available).
  • featured -> Highlight links with a background image or color (same as buttons).
  • buttons -> Add more buttons with your socials URL (see the networks available).
  • footer -> Edit the copyright and URL of the developer (Made just for you 😎).

Icons

Icons are now sourced from the Astro Icons library. You can find the available icons and their usage instructions in the Astro Icons documentation.

Back to top ⬆️

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "feature". Don't forget to give the project a star!

Back to top ⬆️

License

Distributed under the MIT License. Open Source is pretty self-descriptive.

Back to top ⬆️