feat(init): add Vite frontend service template

 - added the --frontend flag and GitLab C as the default platform
 - implemented a Vite/TypeScript template with runtime config and PATH_PREFIX
 - added Docker and CI configurations for GitLab C, GitLab, and GitHub
 - added RSpec and Vitest coverage for generation and runtime settings

Author: Alexander Ludov

Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    stack-service-base (0.0.99)
+    stack-service-base (0.1.0)
       async
       debug
       dotenv

lib/stack-service-base/command_init.rb

@@ -6,12 +6,13 @@ def options(parser)
     parser.on('', '--gitlab-c', 'Gitlab C CI/CD')
     parser.on('', '--gitlab',   'Gitlab CI/CD')
     parser.on('', '--github',   'GitHub CI/CD')
+    parser.on('', '--frontend', 'Vite frontend service')
   end
 
   def run(obj, params, args, _extra)
     if params.empty? || args.empty?
       puts 'Usage:'
-      puts "\tssbase init [option] <service name>"
+      puts "\tssbase init [--frontend] [option] <service name>"
       puts "\tssbase init stack [option]"
       puts 'option: --gitlab-c, --gitlab, --github'
       return
@@ -23,13 +24,14 @@ def run(obj, params, args, _extra)
       type = :stack
       service_name = 'fake-service-name'
     else
-      type = :project
+      type = params[:frontend] ? :frontend : :project
       service_name = first_arg
     end
 
     copy_folder type, :home
 
-    copy_folder type, 'gitlab-c' if params[:gitlab_c]
+    default_platform = params.values_at(:gitlab_c, :gitlab, :github).none?
+    copy_folder type, 'gitlab-c' if params[:gitlab_c] || default_platform
     copy_folder type, 'gitlab' if params[:gitlab]
     copy_folder type, 'github' if params[:github]
 

lib/stack-service-base/frontend_template/github/.github/workflows/main.yml

@@ -0,0 +1,28 @@
+on: { push: { branches: [main,release] } }
+
+jobs:
+  build_service_images:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24.18
+          cache: npm
+          cache-dependency-path: src/package-lock.json
+      - run: npm ci
+        working-directory: src
+      - run: npm run check
+        working-directory: src
+      - uses: docker/login-action@v2
+        with: { username: '${{ secrets.DOCKER_HUB_LOGIN }}', password: '${{ secrets.DOCKER_HUB_PASSWORD }}' }
+      - uses: docker/setup-buildx-action@v3
+      - uses: ruby/setup-ruby@v1
+        with: { ruby-version: 3.4.4 }
+      - run: gem install build-labels
+      - run: env && cd docker && build-labels -n -c docker-compose.yml $(if [ "${GITHUB_REF##*/}" = "release" ]; then echo "--full-version"; fi) github set_version to_dockerfiles to_compose | tee bake.yml
+        env:
+          GITHUB_RUN_NUMBER: ${{ github.run_number }}
+      - uses: docker/bake-action@v5
+        env: { REGISTRY_HOST: '${{ secrets.DOCKER_HUB_LOGIN }}' }
+        with: { workdir: ./docker, files: bake.yml, push: true }

lib/stack-service-base/frontend_template/github/docker/docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  ${service_name}:
+    image: ${REGISTRY_HOST}/${service_name}
+    build:
+      context: ../src
+      additional_contexts:
+        docker: ../docker
+      dockerfile: ../docker/frontend/Dockerfile
+    ports:
+      - "7000:8080"
+    environment:
+      API_BASE_URL: ${API_BASE_URL:-}
+      BACKEND_URL: ${BACKEND_URL:-http://127.0.0.1:65535}
+      LOG_LEVEL: ${LOG_LEVEL:-info}
+      PATH_PREFIX: ${PATH_PREFIX:-}

lib/stack-service-base/frontend_template/gitlab-c/.gitlab-ci.yml

@@ -0,0 +1,24 @@
+stages:
+  - first
+
+.build_block: &build_block
+  stage: first
+  tags: [ build ]
+  needs: [ ]
+  image: docker:27.5.1
+  script:
+    - export CI_COMMIT_TAG="${CI_COMMIT_TAG:-0.0.0}"
+    - docker run --rm `env | grep -o '^CI_[^=]*' | sed 's/^/-e /'`
+      -v /var/run/docker.sock:/var/run/docker.sock
+      -v /root/.docker:/root/.docker
+      $(docker build -q -t build/${CI_PROJECT_NAME} -f docker/Dockerfile.build .) 2>&1
+
+build push:
+  <<: *build_block
+
+tests:
+  <<: *build_block
+  variables:
+    CI_SKIP_PUSH: true
+    # build-labels sets target for each service in docker-compose.yml
+    CI_BUILD_TARGET: tests

lib/stack-service-base/frontend_template/gitlab-c/docker/Dockerfile.build

@@ -0,0 +1,17 @@
+FROM ruby:3.4.4-slim-bookworm AS base
+RUN apt update && apt install -y --no-install-recommends bash git
+RUN gem install build-labels:0.0.79
+RUN BUILDX_VERSION=v0.20.1 COMPOSE_VERSION=v2.33.0 install-docker-static 27.5.1
+
+WORKDIR /build
+
+COPY . .
+
+CMD ["bash", "-c", "-x", "\
+    env && cd /build/docker && \
+    build-labels -n -c docker-compose.yml changed gitlab set_version to_dockerfiles to_compose | tee bake.yml && \
+    export OTEL_RESOURCE_ATTRIBUTES=service.name=docker-builder,pipeline.id=${CI_PIPELINE_ID},project.name=${CI_PROJECT_NAME} && \
+    export REGISTRY_HOST=$CI_REGISTRY_HOST &&  export BUILDX_BAKE_ENTITLEMENTS_FS=0 && \
+    grep \"services: {}\" bake.yml || docker buildx bake -f bake.yml $([ -z \"$CI_SKIP_PUSH\" ] && echo \"--push\") && \
+    ([ \"$CI_BUILD_TARGET\" = \"tests\" ] && (docker compose -f bake.yml down && docker compose -f bake.yml up --force-recreate ) || true) \
+    "]

lib/stack-service-base/frontend_template/gitlab-c/docker/docker-compose.yml

@@ -0,0 +1,15 @@
+services:
+  ${service_name}:
+    image: ${REGISTRY_HOST}/${service_name}/${CI_COMMIT_BRANCH}
+    build:
+      context: ../src
+      additional_contexts:
+        docker: ../docker
+      dockerfile: ../docker/frontend/Dockerfile
+    ports:
+      - "7000:8080"
+    environment:
+      API_BASE_URL: ${API_BASE_URL:-}
+      BACKEND_URL: ${BACKEND_URL:-http://127.0.0.1:65535}
+      LOG_LEVEL: ${LOG_LEVEL:-info}
+      PATH_PREFIX: ${PATH_PREFIX:-}

lib/stack-service-base/frontend_template/gitlab-c/docker/local_build.sh

@@ -0,0 +1,11 @@
+CI_PROJECT_NAME=${service_name}
+export CI_PIPELINE_ID=local
+export CI_PIPELINE_IID=0
+export CI_REGISTRY_HOST=localhost
+export CI_SKIP_PUSH=true
+
+#  -v /root/.docker:/root/.docker \
+docker run --rm --env-file <(env | grep ^CI_) \
+  -v /var/run/docker.sock:/var/run/docker.sock \
+  $(docker build -q -t build/${CI_PROJECT_NAME} -f Dockerfile.build ..) 2>&1
+

lib/stack-service-base/frontend_template/gitlab/.gitlab-ci.yml

@@ -0,0 +1,48 @@
+stages:
+  - test
+  - build
+
+.build_block: &build_block
+#  tags: [ build ]
+  image: docker:27.5.1-cli
+  services:
+    - name: docker:27.5.1-dind
+      alias: docker
+  variables:
+    DOCKER_HOST: tcp://docker:2375
+    DOCKER_TLS_CERTDIR: ""
+  script:
+    - export CI_COMMIT_TAG="${CI_COMMIT_TAG:-0.0.0}"
+    - |
+      if [ -n "${CI_REGISTRY:-}" ] && [ -n "${CI_REGISTRY_USER:-}" ] && [ -n "${CI_REGISTRY_PASSWORD:-}" ]; then
+        echo "${CI_REGISTRY_PASSWORD}" | docker login "${CI_REGISTRY}" -u "${CI_REGISTRY_USER}" --password-stdin
+      fi
+    - docker buildx create --name "${CI_PROJECT_NAME}-wrapper-builder" --driver docker-container --use || docker buildx use "${CI_PROJECT_NAME}-wrapper-builder"
+    - docker buildx inspect --bootstrap
+    - |
+      docker buildx build --load \
+        -t build/${CI_PROJECT_NAME} \
+        -f docker/Dockerfile.build \
+        --cache-from type=registry,ref=${CI_REGISTRY_IMAGE}/ci-wrapper:${CI_COMMIT_REF_SLUG}-cache \
+        --cache-to type=registry,ref=${CI_REGISTRY_IMAGE}/ci-wrapper:${CI_COMMIT_REF_SLUG}-cache,mode=max \
+        .
+    - docker run --rm `env | grep -o '^CI_[^=]*' | sed 's/^/-e /'`
+      -e REGISTRY_HOST=$CI_REGISTRY/$CI_PROJECT_NAMESPACE
+      -v /var/run/docker.sock:/var/run/docker.sock
+      -v /root/.docker:/root/.docker
+      build/${CI_PROJECT_NAME} 2>&1
+
+build push:
+  <<: *build_block
+  stage: build
+  needs: [ tests ]
+
+tests:
+  <<: *build_block
+  stage: test
+  variables:
+    DOCKER_HOST: tcp://docker:2375
+    DOCKER_TLS_CERTDIR: ""
+    CI_SKIP_PUSH: true
+    # build-labels sets target for each service in docker-compose.yml
+    CI_BUILD_TARGET: tests

lib/stack-service-base/frontend_template/gitlab/docker/Dockerfile.build

@@ -0,0 +1,36 @@
+FROM ruby:3.4.4-slim-bookworm AS base
+RUN apt-get update && apt-get install -y --no-install-recommends bash ca-certificates curl git tar \
+    && rm -rf /var/lib/apt/lists/*
+RUN gem install build-labels:0.0.79
+RUN BUILDX_VERSION=v0.20.1 COMPOSE_VERSION=v2.33.0 install-docker-static 27.5.1
+
+WORKDIR /build
+
+COPY .. .
+
+CMD ["bash", "-euo", "pipefail", "-c", "\
+    cd /build/docker; \
+    if [ -n \"${CI_REGISTRY:-}\" ] && [ -n \"${CI_REGISTRY_USER:-}\" ] && [ -n \"${CI_REGISTRY_PASSWORD:-}\" ]; then \
+      echo \"$CI_REGISTRY_PASSWORD\" | docker login \"$CI_REGISTRY\" -u \"$CI_REGISTRY_USER\" --password-stdin; \
+    fi; \
+    build-labels -n -c docker-compose.yml changed gitlab set_version cache to_dockerfiles to_compose | tee bake.yml; \
+    export OTEL_RESOURCE_ATTRIBUTES=\"service.name=docker-builder,pipeline.id=${CI_PIPELINE_ID:-local},project.name=${service_name}\"; \
+    export REGISTRY_HOST=\"${REGISTRY_HOST:-${CI_REGISTRY_HOST:-${CI_REGISTRY_IMAGE:-}}}\"; \
+    : \"${REGISTRY_HOST:?REGISTRY_HOST, CI_REGISTRY_IMAGE, or CI_REGISTRY_HOST is required}\"; \
+    export BUILDX_BAKE_ENTITLEMENTS_FS=0; \
+    if grep -q \"services: {}\" bake.yml; then \
+      echo \"No changed services to build.\"; \
+      exit 0; \
+    fi; \
+    docker buildx create --name \"${service_name}-builder\" --driver docker-container --use || docker buildx use \"${service_name}-builder\"; \
+    docker buildx inspect --bootstrap; \
+    if [ -n \"${CI_SKIP_PUSH:-}\" ]; then \
+      docker buildx bake --load --allow=fs.read=../src -f bake.yml; \
+    else \
+      docker buildx bake --push --allow=fs.read=../src -f bake.yml; \
+    fi; \
+    if [ \"${CI_BUILD_TARGET:-}\" = \"tests\" ]; then \
+      docker compose -f bake.yml down --remove-orphans; \
+      docker compose -f bake.yml up --no-build --force-recreate --abort-on-container-failure; \
+    fi \
+    "]