ngn 8e49322395
All checks were successful
Build the docker image for the API / build (push) Successful in 9s
Build the docker image for the frontend application / build (push) Successful in 8s
Build the docker image for the doc server / build (push) Successful in 9s
update repo name in the badge urls
Signed-off-by: ngn <ngn@ngn.tf>
2025-01-20 19:25:56 +03:00
2025-01-18 04:51:53 +03:00
2025-01-18 04:51:53 +03:00
2025-01-18 04:51:53 +03:00
2025-01-20 08:04:04 +03:00
2023-11-12 17:43:23 +03:00
2025-01-17 04:23:34 +03:00
2025-01-20 19:25:56 +03:00
2025-01-20 09:44:07 +03:00

website | my personal website

This repo contains all the source code for my personal website, ngn.tf All code is licensed under AGPL version 3 (see LICENSE.txt)

Directory structure

app

Contains frontend application, written with SvelteKit. It supports full SSR. Contains modified CSS from github-markdown-css and fonts from NerdFonts

api

Contains the API server, written in Go. It uses the Fiber web framework which offers an Express like experience. I choose Fiber since I've used worked with express a lot in the past. However previously the I was using Gin (see history section).

API stores all the data in a local SQLite(3) database. Go doesn't support SQLite3 out of the box so I'm using mattn's sqlite3 driver.

doc

Contains the documentation server, written in C. It uses the ctorm web framework, which is a framework that I myself wrote. Unlike the frontend application or the API server, it's not accessable by public, the frontend application gets the documentation content from this server and renders it using SSR. The reason I don't use the API for hosting the documentation content is that I want a separate server for hosting static content, API is only for hosting dynamic stuff.

admin

The frontend application does not contain an admin interface, I do the administration stuff (such as adding news posts, adding services etc.) using the python script in this directory. This script can be installed on to the PATH by running the Makefile install script. After installation it can be used by running admin_script.

Deployment

Easiest way to deploy is to use docker. There is compose.yml and a run.sh script in the deploy directory that can be used to startup all the docker containers. Configuration options are passed during build time for the frontend application, and for others it's passed with environment variables.

History

Some nostalgic history/changelog stuff (just for the major version numbers):

  • v0.1 (late 2020 - early 2021): First ever version of my website, it was just a simple HTML/CSS page, I never published any of the source code and I wiped the local copy on my USB drive in early 2022, I still remember what it looked like though, it looked like I made entire website in microsoft paint... while blindfoled, so yeah it was shit.

  • v1.0 (early 2021 - late 2022): This version was actualy hosted on my github.io page, and all the source code was (and still is) avaliable, it was just a simple static site, here is a screenshot.

  • vLOST (late 2022 - early 2023): As I learned more JS, I decided to rewrite (and rework) my website with one of the fancy JS frameworks. I decided to go with Svelte. Not the kit version, at the time svelte did not support SSR. I do not remember writting an API for it so I guess I just updated it everytime I wanted to add content? It was pretty much like a static website and was hosted on ngn13.fun as at this point I had my own hosting. The source code for this website was in a deleted github repository of mine, I looked for a local copy on my old hard drive but I wasn't able to find it. I also do not remember how it looked like, sooo this version is pretty much lost :(

  • v2.0 (early 2023 - late 2023): After I discovered what SSR is, I decided to rewrite and rework my website one more time in NuxtJS. I had really "fun" time using vue stuff. As NuxtJS supported server-side code, this website had its own built in API. This website was also hosted on ngn13.fun. This also the first version that lives on this git repository.

  • v3.0 (2023 august - 2023 november): In agust of 2023, I decided to rewrite and rework my website again, this time I was going with SvelteKit as I haven't had the greatest experience with NuxtJS. SvelteKit was really fun to work with and I got my new website done pretty quickly. (I don't wanna brag or something but I really imporeved the CSS/styling stuff ya know). I also wrote a new API with Go and Gin. I did not publish the source code for the API, the code lived on my local git server until I deleted it when I was done with 6.0. This website was hosted on ngn13.fun as well.

  • v4.0 (2023 november - 2024 october): In this version the frontend was still similar to 3.0, the big changes are in the API. I rewrote the API with Fiber. This version was the first version hosted on ngn.tf which is my new domain name. Here is a picture of the index and the blog page.

  • v5.0 (2024 october - 2025 january): This version just had simple frontend UI changes compared to 4.0, at this point I was thinking about doing a massive rework (which I did with 6.0), however I was working on some other shit at the time, so I just did some small changes with the limited time I had for this project.

  • v6.0 (2025 january - ...): The current major version of my website, frontend had a massive rework, API has been cleaned up and extended to do status checking for the services I host. The doc server has been added to the mix so I can host static documentation. The most important thing about this version is that it adds multi-language support, so literally everything on the website (including the API and documentation content) is localized for both English and Turkish, which was something I wanted to do for the longest time ever.

Damn it has been 4 years since I wrote that shit HTML page huh? Time flies...

Screenshots (from v6.0)

Description
My personal website
https://ngn.tf
Readme 9.3 MiB
Languages
Go 34.4%
Svelte 21.9%
CSS 21.2%
Python 13.2%
JavaScript 7.1%
Other 2.2%