This repository hosts the source code for my personal website (and "digital garden") on jarmos.dev. The website is built on the following tech stack;
Astro
for building the website.Vercel
for hosting the static site.Terraform
for managing the deployment to Vercel and other cloud resources required for proper functioning of the website.
The project is my nth attempt at rebuilding it from scratch and this time I used Astro. If you're looking for the previous version of the website built using Next.js, then head over to this archived repository.
The rebuild took me a surprising <2 weeks time and all of it can be credited to the fact that my prior knowledge in HTML, CSS and JS were pretty handy and it transferred well! Astro also has inbuilt Markdown support which was one of the main concern I had with Next.js and the rest of the other tools I used years ago! Those required third-party dependencies for even the most simplest Markdown setup. And there's no guranteed the dependencies would keep working considering how often Vercel ships breaking changes to the Next.js API.
That said, the project is structured in the following manner;
.
βββ .github
βββ terraform/
β βββ main.tf
β βββ # ...more Terraform code
βββ web/
βββ src/
β βββ # ...Astro website source code
β βββ pages/
β βββ index.astro
βββ README.md
βββ astro.config.ts
βββ # ...more stuff related to the frontend
βββ package.json
βββ tsconfig.json
The main directories of particular interest are: web
and
terraform
which contains the Astro source code and the
Terraform source code respectively. The former is meant for the website and the
former is for deployment and cloud resource management. The root of the project
also contains a couple other directories/folders and they are;
.github
containing configuration files used by GitHub for Dependabot, issue/pull request templates and much more..precommit-config.yaml
is used by the Pre-Commit framework to creategit-hooks
.- The
.gitattributes
,.gitignore
,.editorconfig
files are used by Git and Text Editors respectively. - The
LICENSE
and theREADME.md
contain the licensing terms and conditions and the doucmentations for the project. Taskfile.yml
contains various commands (or "tasks") for the Task runner.commitling.config.js
contains the configurations forcommitlint
for ensuring the project follows a standardisedgit-commit
format.
That said, the next section of the documentation will help you get started with developing/using the tools of the project to build your website (or contribute to this project).
This project is rather quite simple to get started with and has been thoroughly documented wherever it is necessary. In other words, as long as you've the necessary foundational experience and knowledge in the tech stack used in the project you'll be fine. As a refresher, if you want to learn a bit about the tools used in the project, following are the necessary resources you'll ever need;
Once you've completed the tutorials ensure you've the following tools installed on your local development environment;
With the aformentioned tools installed and verified, follow these instructions to get started with developing the website;
-
Fork the repository, so that you can have your own personal copy of the project. You'll be making Pull Requests to the "main" (or
upstream
) repository from your forked repository. -
Clone the contents of the forked repository by running;
git clone [email protected]:<YOUR-USERNAME>/jarmos.dev
- Change directory to the cloned repository and then run the following command
to install the necessary dependencies and the
git-hooks
for quality assurance checks.
task setup
- Once all the dependencies are installed and setup, run the development webserver using;
task
- After making proper changes to the source code, run the production build of the website for a sanity check;
task preview
- If the production build of the website looks sane and satisfactory, run the quality assurance checks by invoking;
task qa
- If all the QA checks passes, commit your changes and push them to your forked repository. From there you will be able to create a Pull Request which will then invoke a more comprehensive QA check. If those passes as well, your PR with all your changes to the repository will be merged and deployed to the production version of the website automatically!
During the entire usage and development phase if you stumble across any issues/hurdles please don't hesitate to open a discussion/issue thread detailing what your concers are and I'll be glad to help you out!
I stood on the shoulder's of giants when working on this project and without whose help, inspiration and shared work, this project wouldn't have seen the light of the day! Hence, following are a list of people who work has directly helped me create the project in its current form:
- Tania Rascia for inspiring me to create the website from scratch and with a pinch of personal creativity!
- Ryan Warner for sharing the Figma template of the website in the public domain!
And in addition, the contributors of the project deserves some love and attention too for pointing out the little mistaks, bugs and more I probably missed out on when working on the project.
The entire project is based on transparency and the open-source initiative.
Hence everything related to the project are made available in the public domain
for scrutiny. The source code (available under the web
& the
terraform
directories) of the website are licensed under the
MIT License. And the literary content found under
we/src/content
in Markdown files and the rendered content
on the website - Blogposts | Somraj Saha are all
licensed under CC BY 4.0.
Hence, under the terms and conditions of the aforementioned licenses, you're free to:
- Copy & modify the contents of the website for commercial or non-commercial uses.
- Distribute the source code as is made available in the repository or modified.
- Share the literary contents after providing due credits to the original author.