"A blazingly-fast and easy-to-use portfolio template for developers of any level AND FOR FREE?!!? 😱 " - Steve Jobs, probably
"I've never seen anything like this before. It's amazing!" - everyone that's ever used this template
This repository is a template, which means that it can be used as a base for other repositories. This is useful for creating new repositories with the same files and directory structure as this one, whilst not maintaining the git history of the template repository. To create a new repository using this template, click on the Use this template
button on the top of the page.
To learn more about template repositories, check out the GitHub documentation.
This project showcases a portfolio as a dashboard containing all public Github repositories of the user (myself, in this case). Built and generated using Astro, Tailwind CSS and DaisyUI. All pages inside the /repo
subroute are rendered server-side and shipped with minimal JavaScript. Each page's content is fetched using the Github API and rendered using Astro's built-in server-side rendering and a Vercel SSR adapter for Astro Apps.
The project's structure is malleable and can be easily adapted to your needs. To get started with your own version of this portfolio, follow these steps:
- Create a new repository using this template by clicking on the
Use this template
button on the upper-right corner of the page or by runninggh repo create <repository-name> --template nivaldofarias/portfolio-template
. - Clone the new repository to your local machine and navigate to the project's directory.
- Install the project dependencies by running
npm install
oryarn install
. - Create a
.env
file and populate with the variables from the.env.example
file.GITHUB_API_TOKEN
: A personal access token. This is required to fetch your repositories and profile information from the Github API. Make sure to enable read access to your repositories.GITHUB_API_OWNER
: Your Github username.GITHUB_API_URL
: The Github API base URL. This is usuallyhttps://api.github.com
.GITHUB_API_VERSION
: The Github API version. This is usually2022-11-28
.
- Run
npm run dev
oryarn dev
to start the development server. - Open http://localhost:3000 with your browser.
- Start editing the project.
Since Astro apps run on top of Vite, all changes are hot reloaded and reflected in the browser immediately.
This project is configured to be deployed to Vercel with web analytics enabled. This can be easily configured to use any other platform of your choice, which all available options are listed in the Astro documentation. To deploy your own version of this portfolio to Vercel, follow these steps:
- Create an account on Vercel.
- On your dashboard, create a new project and link it to your forked repository.
- Navigate to the settings tab and configure the project's environment variables by copying and pasting the variables from your
.env
file. - Deploy.