Paul Le Tran dot com

MIT licensed.

Table of contents

• Overview
  • Notable features
  • Reporting vulnerabilities
• Built with:
• Google Lighthouse scores
• Acknowledgments

---

Overview

This repository hosts all assets and source code used to build the website showing the internet who I am.

In the world of academia and economics, uniquely designed personal websites that are also optimised for performance and best practices aren't common. My website is an exception.

View it here: Paul Le Tran dot com

(back to top.)

---

Reporting vulnerabilities

If you discover a vulnerability/error/mistake in the production code of my website, please refer to the instructions found in SECURITY.md for instructions on reporting these issues. I will then address the problem as soon as possible.

(back to top.)

---

Notable features

Below are some features of my website that I feel are noteworthy:

• The website source code is entirely vanilla HTML5, CSS, and JS. This was consciously done to make the source code (and all of its mistakes) completely understandable to all programmers.

• Entire website is written in semantic HTML.

  • Usage of div and span tags are strictly for styling purposes and kept at a minimum.
  • Semantic HTML tags also comply with ARIA accessibility requirements (e.g., sections and articles having headings).
  • Every img tag has a relevant alt attribute for both screen reader compatibility and legal requirements.

• Entire website is designed to be responsive for almost all common display resolutions, both desktop and mobile.

  • This includes displays as small as the iPhone4 to as large as widescreen desktop monitors.
  • Uncommon display resolutions such as the Galaxy Fold, Surface Duo, and Nest Hub are also supported.

• Entire website is designed to be accessible for all input types.

  • Every page, menu, and link can be navigated using a mouse, keyboard, or touch.
  • Research and More pages feature live filtered search for publications with ARIA22 accessibility by explaining what occurs in the live search when keywords are typed and displaying number of results in real-time.

• Entire website uses JetBrains Mono as its sole font. This is because the font is not only clean and legible (this is especially helped by the increased letter height), but has ligature support, italics support, wide language support, and is both free and open source.

  • The font is also my font-of-choice for all development interfaces, since it's a typeface designed for development.

• Every website page is fully interactive within 2 seconds, including on 3G mobile connections. This is achieved by:

  • Critical CSS for initial rendering of every page is inlined in the head tags.
    • All non-critical CSS preloaded and asynchronously loaded.
  • Web fonts (i.e., JetBrains Mono) are loaded with font-display: optional;. The website's fallback font, Courier New, has been tuned and optimised to mimic JetBrains Mono. This makes the web font "nice to have" rather than a critical component to experiencing the website. Thus, the font property and attribute prevents FOIT, but allows for JetBrains Mono to appear on first page view if it loads within ~100ms.
  • All JS is asynchronously loaded.
  • All graphics are served in compressed .webp format (with compressed .jpg as a fallback)
    • All graphics are lazily loaded for minimal FOIT.
  • HTML5 and CSS code pass the W3C validator with no errors.

• Every website page has a Google Lighthouse score of 100/100 on both mobile and desktop platforms.

  • I am not including the Google Lighthouse scores of my project sub-sites (e.g., econ-grad-app-deadlines). This is because these subsites are generated using the default GitHub Pages theme of Cayman. As a result, the scores wouldn't be reflecting my own design and code.
  • I only update the Google Lighthouse scores after a fundamental change in my website, such as major changes in the layout, content, or coding semantics.

• Favicon support for every platform (with different favicon embedded for night mode support).

(back to top.)

---

Built with

• Vanilla HTML5
• Vanilla CSS
• Vanilla JS
• GitHub Pages for hosting
• Google Domains for the awesome domain
• CloudFlare for DNS management and security, full SSL/TLS encryption mode, HTTPS enforcement, Argo smart routing, Brotli compression, tiered cache, the fancy green lock 🔒, and a whole lot more
• git for source control

(back to top.)

---

Google Lighthouse scores

100/100 for every website page on both mobile and desktop platforms. You can't get anymore optimised than that.

To view the full reports, please visit this subdirectory and paste the respective JSON file into the Lighthouse Report Viewer.

(back to top.)

---

Acknowledgements

Below are the awesome resources used to make my website as optimised as possible:

• Autoprefixer CSS
• google-webfonts-helper
• font-style-matcher
• FontSquirrel
• remedy.css
• reset.css
• Minimal Google Analytics 4 Snippet with localstorage support (2kb v. 179kb+ when compiled with Google Compiler Service!)
• Real Favicon Generator
• jonasjacek's comprehensive robots.txt
• Hilman Ramadhan's live filtered search
• Harry Roberts's ct.css for optimising head tag elements
• Unminify and its wonderful CSS prettification for quick updates of critical inline CSS
• Kevin Powell's tutorial on CSS variables

(back to top.)

---