Nemanjam Github Io

Abstract

1. Introduction

By the end of 2023. I started thinking about capturing insights from my usual daily coding work into rounded blog articles, so I started looking for a clean, minimalistic and well structured blog template. I started researching and considered Jekyll, Hugo, Next.js but eventually realized that currently Astro is the best tool for a static, personal website.

I intend to use this website for years to come, so I consider the extra effort well spent. Additionally, it helped me gain some practical experience with Astro in the process.

This is the repository for my coding blog nemanjamitic.com. Free and open source, feel free to reuse code and customize for your own developer blog. Blog posts (future) require attribution.

2. Objective

Developer blog website built with Astro and Tailwind.

This project demonstrates how MDX, React, Tailwind CSS can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• Latest Astro, static, high performance website
• Post and Project content collections
• Tailwind responsive design
• Color themes with light/dark modes
• Tags and Categories, pagination
• Optimized images, view transitions
• Extracted constants, types, utils, configs, queries, assets
• Full TypeScript, Zod schemas, validated config
• ESLint, Prettier, path aliases, sorted imports
• React for interactive components

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/nemanjam/nemanjam.github.io.git
cd nemanjam.github.io

# Dockerhub user and pass
DOCKER_PASSWORD
DOCKER_USERNAME

# remote server ssh credentials
REMOTE_HOST
REMOTE_KEY_ED25519
REMOTE_PORT
REMOTE_USERNAME

# /home/username/.ssh/config

# arm1 ssh alias for remote server
Host arm1 123.123.13.123
    HostName 123.123.13.123
    IdentityFile ~/.ssh/my-servers/arm1-ssh-private-key.key
    User your-user

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by nemanjam and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.