I did it again. I had to.

Every developer/designer has been here a number of times. Some more than others. Me, surely more than everyone 😅. Where is this? Creating another portfolio site. This place is too stressful.

Coming up with a site format that display many aspect of your career and personality is very daunting. Sometimes you start out very ambitious (after being inspired by others); animation + colors + responsiveness coolness. Sometimes, dammit, you want it simple. One column, not too many colors. Fast! And label it as “Web Standards Compliant”.

It’s hard.

I have kept my previous website for about a year now. It was built with Docusaurus so I didn’t have to worry much about design. Only thing I had to worry about was the homepage, which I believe I killed it — in a simple way. I also did some few style overrides on the content pages and that was it.

The following is a video demo of my old site.

Content? Happy?

But deep down I didn’t like Docusaurus entirely. I found myself swizzling components so I could override styles or hide some elements, etc. Now this was risky as Docusaurus could publish updates in future which will break things. I don’t like uncertain futures like this.

I like control.

The blog and content pages weren’t fulfulling my design aesthetics requirements. Achieving what I wanted meant building on top of Docusaurus — remember swizzling? That is a huge inconvenience [for me].

Then I found Astro. I fell in love with Astro at first sight1. Astro gives you total control. Astro doesn’t get in the way. Astro says, bring any frontend framework when you need them.

Isn’t that wonderful?

Your project is rendered at build time — into HTML. No hydration things (👀 Docusaurus/React). By the way, I prefer Astro to NextJS.

Cool, so I’ve got the tech. Now the design and the content.


Between the last time I built my previous site and this, I have started and abandoned attempts to redo my site about 6 times. Going crazy, going simple. Going crazy, going simple. I have come to learn that this is as a result of lack of good inspiration, planning and prototyping.

Before setting out to build a site, these three aspects are critical — they form the foundation. In practice, these are actually hard to figure out as there are tremendous amount of inspiration (equally appealing) and planning and prototyping are time consuming.

But this is the formula I’ve come up with (while maintaining some originality):


Layout as you alreay know is the arrangment of [major] content. Choosing a style of layout may demand a level of responsibility in regards to responsiveness. If you don’t want to deal with that, you have the option sticking with a single column + max-width page style.

But, if you want something less boring, what you can do is look through a number of sites/inspirations and choose the layout you want. Remember, you’re only choosing layout style from these sites/inspirations and not the content itself.

When choosing the layout, be mindful of what will be required in code to achieve them and also if they’re immediately practical.

A step further will be to choose different layout styles for different parts of your site from different inspirational sites. Remember that we don’t have the luxury of time, so settle for no more than 2 sites.


Using the same formula as the layout, choose (or learn) component styles from another site. For example, how cards, lists, links, buttons, etc. are presented.

Note that, the goal is to come up with just one style to follow.

If you are not ready for lots of styling here and there, you can make use of CSS libaries. If you’re a Tailwind fanatic, you can checkout daisyUI


Content is the #1 pain point for a lot of people. But it may not be immediately apparent since focus is mostly on appeal. However, when you have your content figured out, it drives how you’ll want to lay out your site and you wouldn’t find yourself glaring at your screen confused about what to do.

Here are some content points for free:

  • Your bio: find a way to introduce yourself. If you don’t have a lot to speak about your technical experience abilities, trying picking something from your personality box. Example, you like to go on trips, you are a cars savant, etc.

  • Your portfolio: Don’t feel obligated to put something very polished. As long as it’s something you’re proud of, post it and talk about it [if you want — the challenges, the tech, etc.].

  • Books/articles you’ve read: + you can give a summary of what you learned

  • Blog. If you like to write, this part is easy already.

It’s somewhat reasonable to have this as the first step before looking for design/layout guides. But the counter-argument is that, looking at design inspirations first can also help you with content ideas.

I’m not sharing a golden rule.


It’s fine to change your site multiple times. As with every iteration, you get to know more of yourself and what you want people to learn about you. With my current iteration, I’ve been able to gather what makes me tick — inspiration. And that’s the theme for this current iteration.

How do you find this site? Let me know in the comments below.


  1. I wanted to wordplay this as: “I fell in love with Astro at first site”. Nevermind!