chore: improve DevX

.devcontainer/devcontainer.json

@@ -0,0 +1,50 @@
+{
+  "name": "Debian",
+  "image": "mcr.microsoft.com/devcontainers/base:bullseye",
+  "features": {
+    "ghcr.io/devcontainers/features/node:1": {},
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {}
+  },
+  "forwardPorts": [
+    4321
+  ],
+  "secrets": {},
+  "remoteEnv": {
+    "GITHUB_TOKEN": "${localEnv:GITHUB_TOKEN}"
+  },
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "eamodio.gitlens",
+        "github.copilot",
+        "github.copilot-chat",
+        "github.vscode-github-actions",
+        "ms-vscode.makefile-tools",
+        "astro-build.astro-vscode",
+        "dbaeumer.vscode-eslint",
+        "esbenp.prettier-vscode",
+        "bradlc.vscode-tailwindcss"
+      ],
+      "settings": {
+        "terminal.integrated.defaultProfile.linux": "zsh"
+      },
+      "mcp": {
+        "servers": {
+          "playwright": {
+            "command": "npx",
+            "args": [
+              "@playwright/mcp@latest"
+            ]
+          },
+          "lighthouse": {
+            "command": "npx",
+            "args": [
+              "lighthouse-mcp"
+            ]
+          }
+        }
+      }
+    }
+  }
+}

Dockerfile

@@ -0,0 +1,14 @@
+FROM ghcr.io/super-linter/super-linter:slim-v8.0.0
+
+HEALTHCHECK --interval=5m --timeout=10s --start-period=30s --retries=3 CMD ["/bin/sh","-c","test -d /github/home"]
+ARG UID=1000
+ARG GID=1000
+RUN chown -R ${UID}:${GID} /github/home
+USER ${UID}:${GID}
+
+ENV RUN_LOCAL=true 
+ENV USE_FIND_ALGORITHM=false
+ENV IGNORE_GITIGNORED_FILES=true
+ENV LOG_LEVEL=WARN
+ENV LOG_FILE="/github/home/logs"
+ENV DEFAULT_BRANCH=main

Makefile

@@ -0,0 +1,88 @@
+.PHONY: help
+
+MAKEFLAGS += --silent
+.DEFAULT_GOAL := help
+
+help: ## Show help message
+	@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n  make \033[36m\033[0m\n"} /^[$$()% a-zA-Z_-]+:.*?##/ { printf "  \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)
+
+include .env
+
+setup: ## Prepare stack to run
+	cd application && npm install
+	cd .github/actions/generate-blog-post && npm install
+	cd .github/actions/generate-brand-content && npm install
+	cd .github/actions/validate-manifest && npm install
+
+start: ## Start application in dev mode
+	cd application && npm run start
+
+lint: ## Run linters
+	cd application && npm run lint -- $(filter-out $@,$(MAKECMDGOALS))
+	$(call run_linter,)
+
+lint-fix: ## Run linters
+	cd application && npm audit --omit=dev
+	cd application && npm run humanize:fix
+	cd application && npm run lint:fix
+	$(MAKE) linter-fix
+
+build: ## Build libs and applications
+	cd application && npm run build
+
+test: ## Run tests
+	cd application && npm run test:ci
+	cd .github/actions/generate-blog-post && npm run test:ci
+	cd .github/actions/generate-brand-content && npm run test:ci
+	cd .github/actions/validate-manifest && npm run test:ci
+
+ci: ## Run tests in CI mode
+	$(MAKE) lint-fix
+	$(MAKE) build
+	$(MAKE) test
+
+linter-fix: ## Execute linting and fix
+	$(call run_linter, \
+		-e FIX_CSS_PRETTIER=true \
+		-e FIX_JSON_PRETTIER=true \
+		-e FIX_JAVASCRIPT_PRETTIER=true \
+		-e FIX_YAML_PRETTIER=true \
+		-e FIX_MARKDOWN=true \
+		-e FIX_MARKDOWN_PRETTIER=true \
+		-e FIX_NATURAL_LANGUAGE=true)
+
+define run_linter
+	DEFAULT_WORKSPACE="$(CURDIR)"; \
+	LINTER_IMAGE="linter:latest"; \
+	VOLUME="$$DEFAULT_WORKSPACE:$$DEFAULT_WORKSPACE"; \
+	docker build --build-arg UID=$(shell id -u) --build-arg GID=$(shell id -g) --tag $$LINTER_IMAGE .; \
+	docker run \
+		-v $$VOLUME \
+		--rm \
+		-w "$$DEFAULT_WORKSPACE" \
+		-e DEFAULT_WORKSPACE="$$DEFAULT_WORKSPACE" \
+		-e GITHUB_WORKSPACE="$$DEFAULT_WORKSPACE" \
+		-e FILTER_REGEX_INCLUDE="$(filter-out $@,$(MAKECMDGOALS))" \
+		-e VALIDATE_TYPESCRIPT_PRETTIER=false \
+		-e VALIDATE_TYPESCRIPT_ES=false \
+        -e VALIDATE_CSS=false \
+		$(1) \
+		$$LINTER_IMAGE
+endef
+
+define docker-compose
+    COMPOSE_DOCKER_CLI_BUILD=1 DOCKER_BUILDKIT=1 docker-compose -f docker-compose.yml -f docker-compose.local.yml -f docker-compose.$(1).yml $(2)
+endef
+
+define open-in-browser
+	@if command -v x-www-browser &> /dev/null ; then x-www-browser $(1); \
+	elif command -v xdg-open &> /dev/null ; then xdg-open $(1); \
+	elif command -v open &> /dev/null ; then open $(1); \
+	elif command -v start &> /dev/null ; then	start $(1);	fi;
+endef
+
+#############################
+# Argument fix workaround
+#############################
+%:
+	@: