WEBSITE-35 - Migrate to Astro & Tailwind CSS Framework

.github/workflows/deploy.yml

@@ -0,0 +1,32 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout your repository using git
+        uses: actions/checkout@v4
+
+      - name: Install, build, and upload your site
+        uses: withastro/action@v2
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -1,6 +1,24 @@
-blogs-builder
-vendor/
-*.exe
-*.test
-*.prof
-*.out
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+# jetbrains setting folder
+.idea/

Makefile

@@ -1,26 +1,20 @@
-.PHONY: help build clean serve
-PORT ?= 8080
+.PHONY: help install dev build preview check clean
 
-help: ## Show command options
-	@echo 'Usage: make [target]'
-	@echo ''
-	@echo 'Available targets:'
-	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z_-]+:.*?## / {printf "  %-15s %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+install:
+	pnpm install
 
-build: ## Build the blogs
-	@echo "Building blogs..."
-	@cd scripts && go build -o ../blogs-builder
-	@./blogs-builder
-	@rm blogs-builder
+dev:
+	pnpm run dev
 
-clean: ## Clean generated files and cache
-	@echo "Cleaning generated files..."
-	rm -rf blog/*
-	rm -f blog/index.html
-	rm -f .blogcache
-	@echo "Clean complete!"
+build:
+	pnpm run build
 
-serve: ## Serve generated files locally
-	@echo "Serving generated files..."
-	@go run github.com/absmach/watchdoc@latest -port=$(PORT) -watch-dirs="content/blogs" -cmd="make build"
+preview:
+	pnpm run preview
 
+check:
+	pnpm astro check
+
+clean:
+	rm -rf dist
+	rm -rf node_modules

README.md

@@ -1,42 +1,41 @@
-# Ultraviolet Website
+# Astro Starter Kit: Minimal
 
-This repository contains the source code for the [Ultraviolet](https://ultraviolet.rs) website and blog.
+pnpm create astro@latest -- --template minimal
 
-## Project Structure
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
 
-- `content/blogs/`: Markdown files for blog posts.
-- `img/blogs/`: Images used in blog posts.
-- `scripts/`: The Go-based static site generator.
-- `scripts/templates/`: HTML templates for the blog listing and individual posts.
-- `blog/`: Generated static files (do not edit manually).
-- `index.html`: The main landing page.
+## 🚀 Project Structure
 
-## Prerequisites
+Inside of your Astro project, you'll see the following folders and files:
 
-- **Go**: Required to run the blog builder.
-- **Make**: Used for task automation.
+```text
+/
+├── public/
+├── src/
+│   └── pages/
+│       └── index.astro
+└── package.json
+```
 
-## Guidelines for Contributors
+Astro looks for `.astro` or `.md` files in the `src/pages/` directory. Each page is exposed as a route based on its file name.
 
-To add a new blog post, follow these steps:
+There's nothing special about `src/components/`, but that's where we like to put any Astro/React/Vue/Svelte/Preact components.
 
-1. Create your content in `content/blogs/` (see [WRITING.md](WRITING.md)).
-2. Build the site locally to generate the static files:
-   ```bash
-   make clean && make build
-   ```
-3. To run live reload server, use:
-   ```bash
-   make serve
-   ```
-   and open a browser at http://localhost:8080.
-4. To run on a different port (if, say, 8080 is taken), use:
-```bash
-   PORT=8081 make serve
-```
-5. Commit both the source Markdown files **and** the generated files in the `blog/` folder.
-6. Open a Pull Request.
+Any static assets, like images, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `pnpm install`            | Installs dependencies                            |
+| `pnpm run dev`            | Starts local dev server at `localhost:4321`      |
+| `pnpm run build`          | Build your production site to `./dist/`          |
+| `pnpm run preview`        | Preview your build locally, before deploying     |
+| `pnpm run astro ...`      | Run CLI commands like `astro add`, `astro check` |
+| `pnpm run astro -- --help`| Get help using the Astro CLI                     |
 
-## Documentation
+## 👀 Want to learn more?
 
-- [How to Write a Blog Post](WRITING.md)
+Feel free to check [our documentation](https://docs.astro.build) or jump into our [Discord server](https://astro.build/chat).

astro.config.mjs

@@ -0,0 +1,9 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import tailwind from '@astrojs/tailwind';
+
+// https://astro.build/config
+export default defineConfig({
+  site: 'https://ultraviolet.rs',
+  integrations: [tailwind()],
+});