I think that everyone should have a personal site, even if you're not in the development scene - and it doesn't always have to be a massive, expensive headache to set up. While this post is aimed at developers, it can still show you have to make site from the ground up, and completely for free! While at present, it may not have much traffic, it is optimised as fuck - 100% lighthouse scores, quick load times, almost instantaneous indexing by Google, the whole shebang. Tech stack used: React with NextJS Hosting on Vercel Custom CSS styling Posts exported from Notion, using gray-matter for metadata Implementation of the GitHub API I was torn between create-react-app and NextJS, but as a general rule of thumb, CRA is great for purely single page apps, whereas next is more appropriate for full on websites. A perk of using this is the fantastic hosting on Vercel, which automatically redeploys on a new git commit. This means that as soon as I push a post to the sites repository, Vercel updates the live site, no fuss. NextJS also offers server-side rendering, which at surface level seems ideal for blogs, but the content on my site was simply not dynamically changing enough to warrant the slightly longer load time associated with SSR, so static seems like the best option - for now. I'm not a designer, far from it - but in my opinion, the site looks pretty clean and minimal. It's done with simple CSS, with some quirky features copied from some CodePens that I found, notably the animated underlines. I didn't have any relevant images, which makes design surprisingly hard, so I decided to focus more on typography. The whole goal of the site was to be concise and to the point, so the design should reflect this. As for the posts, I write them in Notion, which has a handy feature that allows you to export pages as markdown. ReactMarkdown handles the rendering on the page from there. I then use an NPM package called gray-matter to assign each post with metadata (title, date, description) for easy formatting in React. This also allows me to effectively and automatically update the RSS feed, and is overall the biggest time saver I've found for managing posts! I'm about to jump into how I handled some of the main features of the site, if you're not interested in the nerd shit then you can skip to the end to see how to optimize your site for Google. This is how I get all of the posts, it's designed for use in React so the syntax might seem a bit weird: { posts = [] context = .context( , , /\.md$/) ( key context.keys()) { post = key.slice( ); content = ( ); meta = matter(content.default)
        posts.push({ : post.replace( , ), : meta.data.title, : meta.data.date, : meta.data.description,
        })
    } posts;
} export async ( ) function getPosts const const require '../posts' false for const of const 2 const await import `../posts/ ` ${post} const slug '.md' '' title date description return You can see that it returns a list of objects, each with all the required data to display the posts information and route to it. I can then display them in a simple list like this: { router = useRouter() ( <ul>
                {allPosts.map(function (post, key) {
                    return (
                        <li onClick={() => { router.push(`/posts/${post.slug}`) }} key={key} className={styles.tableRow}>
                            <div className={styles.titleContainer}><h2 className={styles.title}>{post.title}</h2></div>
                            <h3 className={styles.date}>{formatDate(post.date)}</h3>
                        </li>
                    )
                })}
            </ul> )
} ( ) function Posts { allPosts } const return < = > div id {styles.container} </ > div Implementing a RSS feed required the same getPosts function, but in pure nodeJS, here's what that looks like - it's a bit easier to understand what's happening: { posts = [] filenames = fs.readdirSync( );

    filenames.forEach( { str = fs.readFileSync( , ); meta = matter(str);
        posts.push({ : file.replace( , ), : meta.data.title, : meta.data.date, : meta.data.description,
        })
    }); (posts)
} ( ) function getPosts var let "posts" ( ) => file const `posts/ ` ${file} 'utf8' const slug '.md' '' title date description return I can then fetch specific posts based on the URL, this object also contains the content of the post, which is rendered to the screen, as well as the other meta-data to be passed as props to the post element. The description is only used for the meta tags for improved SEO: { fileContent = ( ) meta = matter(fileContent.default) post = meta.data content = meta.content { : post.title, : post.date, : post.description, : content
    }
} export async ( ) function getPostBySlug slug const await import `../posts/ .md` ${slug} const const const return title date description content It's pretty simple stuff, which is why I love working with React so much. NextJS handles dynamic routing amazingly, this is my [slug].jsx. The post data gets passed to a very simple post layout using React's getStaticProps method like so: { ( <div id={styles.post}>
                <ReactMarkdown source={props.content} renderers={{code: CodeBlock, image: Image}} />
            </div>
        </PostLayout> ( ) function Post props return < = = = > PostLayout title {props.title} date {formatDate(props.date)} description {props.description} )
}

export async function getStaticProps(context){
    return {
        props: await getPostBySlug(context.params.slug)
    }
}

export async function getStaticPaths(){
    let paths = await getPosts()
    paths = paths.map(post => ({
        params: { slug:post.slug }
    }));
    return {
        paths: paths,
        fallback: false
    }
} With the post layout component working like so: { ( <Head>
                <title>{`${props.title} | Guy Torbet`}</title>
                <meta name='description' content={props.description} />
                <meta property="og:title" content={`${props.title} | Guy Torbet`} />
                <meta property="og:description" content={props.description} />
                <meta name="viewport" content="width=device-width, initial-scale=1" />
                <meta charSet="utf-8" />
            </Head>
            <div id={styles.main}>
                <Header title={props.title} />
        
                <article id={styles.content}>
	                <div id={styles.date}>{props.date}</div>
                    <div id={styles.post}>
                        {props.children}
                        <Mail />
		                 </div>
                </article>

            </div>
        </main>
    ) export default ( ) function PostLayout props return < > main Projects Integration GitHub have a nice web API to allow for you to access all of a users public repository information, you can see what mine returns . here This is pretty much everything for my projects section, I still need to tidy up some of the variable names: { { Title, Description, Language, url };
} { [arrayItems, setArrayItems] = useState([])
    useEffect( () => { fetch( ).then( response.json())
            .then( { items = data.map( { (
                        createData(arraySingleItem.name, arraySingleItem.description, arraySingleItem.language, arraySingleItem.html_url)
                    );
                });
                setArrayItems(items);
            })

    }, []) router = useRouter() ( <ul>
                {arrayItems.map((row) => (
                        <li className={styles.tableRow} onClick={() => { router.push(row.url) }} key={row.Title}>
                            <h2 className={styles.title}>{row.Title}</h2>
                            <h3 className={styles.subTitle}>{row.Description}</h3>
                            <h3 className={styles.subTitle}>{row.Language}</h3>
                        </li>
                ))}
            </ul> );
} ( ) function createData Title, Description, Language, url return export default ( ) function Repos props const async await 'https://api.github.com/users/torbet/repos' => response => data const ( ) => arraySingleItem return const return < = > div id {styles.container} </ > div ensures that the API is only called once every time the page is loaded, this maintains speed whilst ensuring that the page is always up to date. useEffect I love this feature, it means that as soon as I start a new project, it instantly shows up on my site, formatted with the rest of them. Optimising For A Perfect Google Lighthouse Score It's hard to know when you're done working on project, so I gave myself the target of a perfect lighthouse score. I wouldn't recommend this as you may have to change some fundamental parts of your site to comply with the standards, but in my case, it was simply a case of removing unused javascript, adding a few aria labels and changing some colours for better contrast. Maybe I'm a web developing prodigy, just a natural talent - more likely, my site was just simple and I had to jump through the loopholes of SEO, but if Google tells me that this is what I have to do, what choice did I have? (plus you get those nice fireworks) Google Lighthouse is an open-source, automated tool for measuring the quality of web pages. Lighthouse ranks in main categories: 5 : This how the page is, it measures the global performance. With the important metrics being the First Meaningful & Contentful Paints, the Time To Interactive and the Speed Index. Performance fast : This measures how your page is. It performs various checks on the page's elements, like the nd aria label attributes. The audit has to pass a list defined in . Accessibility accessible colour contrast a here : This is the of your page, it measure how much the best practices defined by the or are used and respected. For example, it will check if your page is served via and if errors are present in the console. Best Practices reliability W3C Google's standards HTTPS : This measures how and your page is for search engines. It checks, for example, if the contains and . SEO optimised standardised document meta tags semantic titles : This measures if your website is able to be installable. It has to pass the audit based on the . This isn't normally required for most sites, if you want to start making PWAs, search how to make a manifest.json. Progressive Web App (PWA) Baseline PWA Checklist You need a low Time To First Byte. This means that the server needs to respond fast. I use CloudFlare and Vercel for my website and static site generation for my pages, which is essentially the same as using full server-side caching. These provide adequate response times while still allowing me full control over proxies, analytics and version control. You need to optimise your images. Use SVG and compressed JPG's whenever possible. You can use loading=”lazy” on all image tags to reduce the first contentful paint. The total page size to aim for is under a 1000kb, and images often contribute to a large part of this. Check your bundle size, the less data you send to clients, the better (within reason). NPM packages often have hidden dependancies, driving up total size of your site. There are many tools to track down which modules are taking up the most space, so go through them and make sure you only have ones that you need. Improving the accessibility of a webpage is often simpler than one might expect. While there are bigger changes you can make to improve the accessibility of a website, most things require less than a few minutes to address. Here is a list of some simple improvements that you can make to boost your accessibility rating: Use an appropriate viewport meta tag.Ensure all images have an appropriate alt attribute.Prefer semantic HTML, but fall back to to help identify elements.Ensure links have a minimum clickable area of 44x44. Mobile users will love youUse colours with enough contrast to help the readability of text. Most browser dev tools can help you to find the right combination. ARIA Optimising for lighthouse might take a while, but it helps to be methodical. Work in iterations where you: Target an area. Optimise. Measure the results. GOTO 1. Websites need constant maintenance to stay relevant and up-to-date. As techniques evolve, and the web progresses, we need to adapt what we have to best serve our visitors. Hopefully this article serves as a checklist for your website, and it can help you achieve a better score which, ultimately, not only gives you a chance at a better placement in search engines, but it also serves your visitors with a better experience. If you like this post, feel free to subscribe or check out my other posts here .

Fetch

Google

Instantly

Progressive

Target

An Open Letter to Everybody Having Trouble Getting Started Today

Portfolio

Newsletter

Too Long; Didn't Read

How To Score A Perfect 100 Google Lighthouse Score in Chrome Dev Tools

How To Score A Perfect 100 Google Lighthouse Score in Chrome Dev Tools

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

AI Headline Generation On HackerNoon

10 Chrome Extensions to Transform Your SEO Game

How I Improved My Website Performance Score from 35 to 100

Why Being Likable At Work Matters

Windows Sticky Keys Exploit: The War Veteran That Never Dies

AI Headline Generation On HackerNoon

10 Chrome Extensions to Transform Your SEO Game

How I Improved My Website Performance Score from 35 to 100

Why Being Likable At Work Matters

Windows Sticky Keys Exploit: The War Veteran That Never Dies

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps