Web development nowadays has become so complicated thanks to the creators of thousands of new ways to do the same thing. In the early days of web development he had PHP and jQuery which did pretty much everything we needed. But well things have changed now.
Long Story Short
So, I was looking for a way to build my personal website. Which would have had some blogs and my project showcase that's it, no big deal right? Well, though the same thing as well. So, my initial thought was to use these as my tech stack
- React
- Firebase/Supabase
- Tailwind CSS
- Cloudflare Pages for deploying
Well, this could be the happy ending but... π
As I've already stated I will need a blog section and ironically blogs and react doesn't go well together. Since React is basically for building WebApps not content driven websites. Now those who don't know why here's a summary from chatGPT
Why React is Not Suitable for Content Driven Sites
ChatGPT Said,
React is not ideal for content-driven sites primarily because it relies on client-side rendering, which can negatively impact SEO and initial page load times. Content-driven sites benefit from server-side rendering (SSR) or static site generation (SSG), which React doesn't handle out of the box. Tools like Next.js or Gatsby, which extend React, are better suited for these needs.
Next Target: NextJs
Well it's obvious that I need SSR for blog site since I wanted a good indexing by search engines and a professional social media link previews. NextJs could give me both of those, but there's still a problem, and it's kind of a personal one.
See, I always loved using cloudflare pages and wanted to stick with that, besides I wanted cloudflare's free email routing to have a custom email address attached to my domain thus reducing the cost.
NextJS at Cloudflare
I tried deploying nextJS site to cloudflare pages via their official documentation. Well, things didn't go well. I wasn't able to deploy there I tried hours finding solution and nothing worked. Let's just say nextJS and cloudflare didn't go well together for me. So if anyone from Vercel or Cloudflare reading this correct me if I'm missing something.
Well, at this point I was hopeless and the last option I had was SSG.
Next Solution: SSG
Now SSG is good, and I understand the importance here. The problem is I've never worked with SSG before and there are multiple routes to through. There are things like Hugo, Gatsby, Astro blah blah. And probably more. Now I wasn't familiar with any of those and at this point I was so frustrated that I wasn't willing invest a bit on learning a new tool for a simple blog app. So I was like f*$k it I'll do my own thing.
Creating My Own Static Site Generator.
Few points why I decided to develop my own static site generator
- I was frustrated (of course lol)
- Since I am making my own tool for my own thing, I will have the full control over how the pages will be generated. How will they look like.
- I like to reinvent.
- I had free times to spend.
The Plan
The plan was going old fashioned way of creating website. Separate articles will have their own html pages.
Here's the full outline:
- I'll be writing on palin Markdown files
- Use python to parse the markdown into plain HTML
- I will already have a template where different sections will be dynamically injected.
- Also I'll have a config file corresponding to the article. So the file hierarchy will kinda look like this
articles/
βββ art-1
βΒ Β βββ art.md
βΒ Β βββ config.json
βββ art-2
βΒ Β βββ art.md
βΒ Β βββ config.json
βββ art-3
βΒ Β βββ art.md
βΒ Β βββ config.json
βββ art-4
βββ art.md
βββ config.json
Hence, each post will have it's own folder and the folder will have the config.json
and art.md
, The python script will take the template.html
and insert dynamic contents to that HTML template, for instance the post title, slug, thumbnails from the config file and main article from the parsed markdown file. Most importantly it will dynamically generate meta tags for SEO and social medias.Afterwards, it will write the changes to a file called art/<post-slug>.html
so that the post link will be example.com/art/slug
.
How was it integrated?
Well so I've developed a CLI interface for interacting with the generator. I've named it fit you know as in F it. It has the following commands or options:
$ ./fit --help
fit: also known has f**k it build system
A build system for my personal site developed by Shazin
USAGE
fit <action> <argument>
COMMANDS
init Creates a new post template at articles/art-[n]
build art-<n> Builds the specified article
sync Syncs the global articles index to homepage
uploader Launches the GTK GUI image uploader
upload <file_path> Uploads the specified file to firebase
deploy Deploys local changes to remote repository
help, -h, --help Displays this help menu
Deployment mechanism
So, like I said I wanted to use Cloudflare pages for deploying. Basically what I've done is I've created a branch called prod
and whenever the ./fit deploy
command is run it will basically copy all the necessary files to the prod branch and push the changes to github. Then, cloudflare will automatically build and redeploy the changes.
Handing images
In order to handle images or any static files I have used firebase storage, the ./fit uploader
will pop open a GTK based GUI uploader from which I can upload an image and it will give me the public url which I can than copy, Here's how it looks:
Upload Interface
Post Upload Interface
CLI Interface
There's also a CLI Interface which can be used by ./fit upload <filepath
this was an option for cases where I don't have access to a GUI interface. This allows me to publish or edit articles from my phone as well using terminal emulator like Termux
Dynamic Ambient Bcakground
So, I thought when I am the one handling all the building and generation myself I can definitely do some cool stuffs with it, so I've added a dynamic colored ambient background to each post. The idea was to pick an average color from the thumbnail image and then darken it and use it as the background. I've also picked a primary color for the links and buttons from the thumbnail image as well and honestly to me, it looks really cool, here's an screenshot
Comments and Discussion
Since I was working with basically no database or no backend service at all, I had to choose an external service for this and what else does this better than Disqus .
Was it Worth It?
Well, to be honest like I said I was spending some free times, so yeah it was definitely worth it, and it didn't take me long time to be honest I've spent 2-3 days for this full project and really had fun building something creative.
Wrapping Up
So, I've had really fun experience with this project and will hopefully do more improvements and add more functionalities to it. Right now it's so basic and simple which was what I wanted. If you like this project or want me to open source it please let me know. Oh and here's the link of the site I was screaming about shazin.me Thanks for reading.
Top comments (39)
I've done this before too. I had an incredibly simple site that I wanted to quickly and easily modify from a config file, and some templates. A static-site generator intended for blogs or other content-heavy sites seemed heavy-handed, so I rolled my own SSG using a Makefile, a build script in node, some template files, and a config file in TOML.
Pretty easy, and much better than a more involved Hugo/Jekyll/whatever site.
Refs: site and repo.
I've just checked that. It's cool
Of course if you ask ChatGPT the opposite, it will give some good reasons: "React is a popular choice for static site generation (SSG) due to several key factors that leverage its component-based architecture and the growing ecosystem of tools around it." (It then listed 7 reasons I won't repeat here.)
Try this prompt: Why React is Not Suitable for Content Driven Sites
My point is, you can generally get ChatGPT to say what you want it to say when it comes to matters of opinion :) I have no doubt that it has plenty of negative things to say about using React in that scenario. I wasn't trying to suggest React is great. I just don't think argument by ChatGPT is particularly effective.
Well, to be honest that's actually my opinion, this is just lazy writing. I used chatGPT to generate that portion of the article
Try running a lighthouse report on your site. It can help you optimize performance. (Go to dev tools by pressing CTRL + SHIFT + I, this is available in Chromium-based browsers).
![Lighthouse](https://media.dev.to/cdn-cgi/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2F0unk1ilj4lfpoj9jywjm.png)
Thanks for the suggestion π
There's a list of projects that every developer has to create for themselves, back in the day one of those is a CMS with PHP, another is a game (or beginnings of an unfinished game engine π ), and sometimes it's a static site generator.
The last time I made a static site generator, I used Jinja for the templates with
gettext
for generating translations.π Very cool that you used GTK for the file uploading dialog.
If the site were built for other people to edit/review, it might be worth storing all those Markdown files in Firebase Storage; larger sites with more content writers/editors end up using Contentful or some other headless CMS.
The dynamic ambient background is a cool effect; I've used Unsplash (manually) selecting a random or slightly relevant cover image for posts. There's a lot of directions you can go in when you're writing the static site generator!
Hey, appreciate it man. Since I don't write a lot that's why I didn't consider storing articles on Firestore. The posts are currently staying at my github. If they grow in number I'll definitely do it. Thanks for the suggestion π
Nice! I've seen a couple of different approaches to this problem lately, and they've all been pretty creative (in a good way). I'm particularly happy that this seems to be the trigger for more people to share their content! "Hey, I put all this work into a content system, I might as well start using it."
Thanks
Nice post, and your site looks great! I've tried this too, but I'm not as patient as you, and leaving the project alone for a while made me forget too much, it was more headache than it was worth. IMO the biggest value of doing this is what you learn.
My current site miko.ademagic.com is built on Astro and took me like 3 cli commands to set it live. Now i work on it slowly and continuously, it's great.
Very neat. :)
I left a comment on your site.
Thanks for sharing. This is inspiring!
Thank you for reading βΊοΈ
Good read! Thanks for sharing your journey here Shazin
Thank you! I especially like the dynamic ambient background. It looks beautiful!
I am glad you liked it.
hello everyone! I'm new hereπ
How are you
currently, we are going to build new coin marketplace similar pump.fun or base.fun.
If you have good experience with MERN Stack, I want to collaborate with you
Hey, let's connect. @srshazin/x
That's a really cool website! and an interesting journey to building your own SSG!
I am currently learning the MERN stack and building some fundamental applications. I am trying to get your project's tech-stack overview. Could you confirm if your tech stack was as follows :
If you feel comfortable, please do share the repo. Thanks! π
Hello, I am actually interested in sharing my repo but it's not well organized currently. I'll put a link when it's ready.
My tech stack was fairly simple
Thanks a lot for the detailed answer. 'Build tool' is something that I heard of, but never saw in implementation. That was insightful! Super cool!
This made me think of the process and I have a question for you then, why render page on the server with Python every time page loads, instead of building html file during the deployment and having static content on the server already (going to be faster), you are building the content locally anyways. I know the speed difference is not going to be noticeable for people, but just out of curiosity.
I also built a custom blog some time ago, but I used php. now it is much easier to build it since there are good open-source text editors out there, which was my problem back in the days.
I think you misunderstood the use of python here. I am doing exactly what you're suggesting. I am not using python on the server to generate page on the run time. I am using python to generate static HTML pages during deployment, I'm using BeautifulSoup to insert dynamic contents during build time. On the deployment I have only html css and JavaScript nothing else.
What's SSG role ?
I am quite not sure what you are asking about. Asking about what is SSG or role in my project?