Skip to content

Latest commit

 

History

History
80 lines (54 loc) · 3.74 KB

README.md

File metadata and controls

80 lines (54 loc) · 3.74 KB
Raw

Portfolio

A portfolio designed for lazy developers all over the world. With little configuration and maintanince let this application automatically update itself without you having to lift a finger!

I speak at events, write blog posts, and maintain some libraries. I wanted to create a website that would showcase all of this, and I created this project to host my blog, display my repos from GitHub and show a YouTube playlist!

  • My experience is pulled from LinkedIn and is shown on /.
  • Blog posts I've written are hosted here and shown on /blog.
  • My most starred and recent GitHub repos are shown on /code.
  • Recorded talks are fetched from a YouTube playlist and shown on the /videos.

Almost all of this is configured from a few JSON files in src/_data.

Getting Setup

We'll keep our first step simple and just run a npm ci command. You will also want firebase-tools installed as a global dependency on your machine. Just run the command npm i -g firebase-tools and be sure to sign into your Google account for the firebase-tools with the command firebase login.

Configuration

Some basic details used for generating pages and fetching content on the site is found in the src/environment.ts. Below is an interface explaining the site's data structure. If you don't want one of the optional fields, delete it.

interface Environment {
  name: string; // Your name.
  shortName: string; // Short name for PWA.
  description: string; // A short description about yourself.
  code: {
    githubID: string; // Your GitHub handle.
  }
  videos: {
    youtubePlaylistID: string; // The YouTube Playlist ID to show.
  }
}

Blog

Blog posts are written in Markdown and stored in src/content/blog. The metadata is set in the Front Matter at the top of a Markdown file. Below is an example of what fields are supported and what they should look like.

---
title: My Blog Post's Title
description: A description for this blog post.
pubDate: May 20 2024
hero: https://michaelsolati.com/hero.png
---

LinkedIn

I would like to automate this but LinkedIn makes it near impossible. Using this Chrome extension. Generate a JSON and save the content in src/data/linkedin.json.

Firebase

This application takes advantage of Firebase for the use of its Hosting. In the Firebase console create a new application, and ensure that these features are enabled. Typically they would be enabled from the get-go, but you may want to check just in case.

Update the .firebaserc file in the root directory so that projects.default is assigned to your Project ID. The easiest way to do this is just to delete the file and run the command firbase init to assign it to your project.

YouTube

You will also need to enable the YouTube Data API v3 for your Firebase application, which you can do here. Generate an API token for this and use set it as an environment variable called YOUTUBE. If you don't want to keep setting it you can set it once in a git ignored .env file.

Let's Wind Up

With everything configured and data generated you can test the site by running:

npm run start

If everything looks good then we're ready to deploy to Firebase, run:

npm run build
firebase deploy

Enjoy!