@fishawack/lab-env 4.45.0-beta.1 → 4.45.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## Changelog
 
+### 4.45.0-beta.2 (2025-09-01)
+
+#### Features
+
+* added mcp instructions file ([3f27ac9](https://bitbucket.org/fishawackdigital/lab-env/commits/3f27ac954f440edae1c96439c2f46f1c277ee3c0))
+* added sass instructions file ([563b7ee](https://bitbucket.org/fishawackdigital/lab-env/commits/563b7eebdcfac1904507930b053846fa575bf038))
+* added workspace instructions file ([1838c42](https://bitbucket.org/fishawackdigital/lab-env/commits/1838c42c979c0ad2a0b59f45db9876050ccc2b04))
+* updated vue instructions to have style specifics ([695713a](https://bitbucket.org/fishawackdigital/lab-env/commits/695713a8b2bf61908fb05c331f8b47e7196d2f2d))
+
+#### Bug Fixes
+
+* added note about resources being _Build/sass on static projects ([1b66bb2](https://bitbucket.org/fishawackdigital/lab-env/commits/1b66bb2f206cde8847f9859581b1c87603d161d8))
+* beta branch now installs submodules ([9f78f63](https://bitbucket.org/fishawackdigital/lab-env/commits/9f78f63830562e0e3a0f797a888b0d97465165d0))
+* copy sass instructions on core projects ([70ad3a8](https://bitbucket.org/fishawackdigital/lab-env/commits/70ad3a8d8dfd48c3d208541696619740d8973dfb))
+* renamed files to correct extension ([a54bd0b](https://bitbucket.org/fishawackdigital/lab-env/commits/a54bd0bb59030e20c2e3b35dfbe9aa7b01106103))
+
 ### 4.45.0-beta.1 (2025-09-01)
 
 #### Features

package/_Ai/vue-3.md

@@ -75,12 +75,13 @@ fw npm -v
 
 ## Project Structure Context
 
-- **Vue Components**: Main app component at [`_Build/vue/app.vue`](_Build/vue/app.vue)
-- **Routes**: Page components in [`_Build/vue/routes/`](_Build/vue/routes/) directory
-- **Global Components**: Reusable components in [`_Build/vue/globals/`](_Build/vue/globals/) directory
-- **JavaScript**: Main script at [`_Build/js/script.js`](_Build/js/script.js), utilities in [`_Build/js/libs/`](_Build/js/libs/) directory
-- **Styles**: SASS files in [`_Build/sass/`](_Build/sass/) directory
-- **Templates**: Handlebars templates in [`_Build/handlebars/`](_Build/handlebars/) directory
+- **Vue Components**: Main app component at [`resources/vue/app.vue`](resources/vue/app.vue)
+- **Vue Components**: Reusable components in [`resources/vue/components/`](resources/vue/components/) directory
+- **Vue Routes**: Page components in [`resources/vue/routes/`](resources/vue/routes/) directory
+- **Vue Stories**: Component documentation in [`resources/vue/stories/`](resources/vue/stories/) directory
+- **JavaScript**: Main script at [`resources/js/script.js`](resources/js/script.js), utilities in [`resources/js/libs/`](resources/js/libs/) directory
+- **Styles**: SASS files in [`resources/sass/`](resources/sass/) directory
+- **Templates**: Handlebars templates in [`resources/handlebars/`](resources/handlebars/) directory
 - **Tests**: Unit tests in [`_Test/unit/`](_Test/unit/), UI tests in [`_Test/ui/`](_Test/ui/)
 
 ## Technology Stack
@@ -144,22 +145,85 @@ The project uses Fishawack's custom build system (`@fishawack/core`):
 
 ## Styling Architecture
 
+### Critical Styling Philosophy
+
+**NEVER use `<style>` blocks in Vue components** - All styling is managed through the structured SASS architecture. This enforces separation of concerns and maintains optimal build performance.
+
 ### SASS Structure
 
-- [`_Build/sass/vendor.scss`](_Build/sass/vendor.scss): Third-party imports and lab-ui components
-- [`_Build/sass/general.scss`](_Build/sass/general.scss): Project-specific styles
-- [`_Build/sass/_variables.scss`](_Build/sass/_variables.scss): SASS variables
-- [`_Build/sass/_defaults.scss`](_Build/sass/_defaults.scss): Default overrides
+- [`resources/sass/vendor.scss`](resources/sass/vendor.scss): Third-party imports and lab-ui components (cached for performance)
+- [`resources/sass/general.scss`](resources/sass/general.scss): Project-specific component imports (fast-reloading)
+- [`resources/sass/_variables.scss`](resources/sass/_variables.scss): Project color overrides and custom variables
+- [`resources/sass/_defaults.scss`](resources/sass/_defaults.scss): Lab-UI component setting overrides
+- [`resources/sass/components/`](resources/sass/components/): Individual component style files using BEM methodology
+
+### BEM Methodology
+
+All component styling follows BEM (Block Element Modifier) methodology:
+
+```scss
+// Block: Base component
+.card {
+}
+
+// Element: Component part
+.card__header {
+}
+.card__body {
+}
+.card__footer {
+}
+
+// Modifier: Variant or state
+.card--featured {
+}
+.card--compact {
+}
+.card__header--sticky {
+}
+```
+
+**Vue Template Example:**
+
+```vue
+<template>
+    <article class="card card--featured">
+        <header class="card__header card__header--sticky">
+            <h2 class="card__title">{{ title }}</h2>
+        </header>
+        <div class="card__body">
+            <p>{{ content }}</p>
+        </div>
+    </article>
+</template>
+```
 
 ### UI Library Integration
 
-Uses `@fishawack/lab-ui` for:
+Uses `@fishawack/lab-ui` utility-first framework providing:
+
+#### Utility Classes (Tailwind-like system):
 
-- Typography system
-- Grid system
-- Button components
-- Utility classes
-- Color system
+- **Spacing**: `m-0`, `m-0.5`, `m-1.5`, `p-2`, `p-3`, `p-4`
+- **Colors**: `bg-1` through `bg-6`, `color-1` through `color-6`
+- **Grid**: `grid__6/12`, `mobile:grid__12/12`, `grid--gutters`
+- **Flexbox**: `flex`, `justify-center`, `items-center`, `flex-column`
+- **Typography**: `text-center`, `font-600`, `uppercase`
+- **Display**: `block`, `hidden`, `mobile:hidden`, `tablet:block`
+
+#### Responsive Breakpoints:
+
+- `mobile:` - 767px and below
+- `tablet:` - 1023px and below
+- `desktop:` - 1299px and below
+
+#### Base Components:
+
+- Typography system with semantic font weights
+- 12-column flexbox grid system
+- Button component base with extensive customization
+- Form components with validation states
+- Utility classes for spacing, colors, and layout
 
 ## Testing Guidelines
 
@@ -187,17 +251,241 @@ fw npm run test
 
 ## Development Guidelines
 
+### Vue Component Styling Rules
+
+**CRITICAL**: Never use `<style>` or `<style scoped>` blocks in Vue components. All styling must be managed through the SASS architecture.
+
+#### Correct Approach:
+
+```vue
+<!-- MyComponent.vue -->
+<template>
+    <div class="my-component my-component--featured">
+        <header class="my-component__header">
+            <h2 class="my-component__title">{{ title }}</h2>
+        </header>
+        <div class="my-component__body">
+            <p>{{ content }}</p>
+        </div>
+    </div>
+</template>
+
+<script>
+export default {
+    name: "MyComponent",
+    props: ["title", "content"],
+};
+</script>
+
+<!-- NO <style> block - styles are in resources/sass/components/_my-component.scss -->
+```
+
+#### Corresponding SASS File (`resources/sass/components/_my-component.scss`):
+
+```scss
+.my-component {
+    // Use lab-ui utilities when possible
+    @apply bg-0 p-2 grid--gutters;
+
+    border: 1px solid $color6;
+    border-radius: 4px;
+
+    &__header {
+        @apply border-color-6 pb-1;
+        border-bottom: 1px solid;
+    }
+
+    &__title {
+        @apply font-600 color-4;
+        margin: 0;
+    }
+
+    &__body {
+        @apply pt-1;
+    }
+
+    // Modifier for featured variant
+    &--featured {
+        border-color: $color1;
+        box-shadow: 0 4px 8px rgba($color1, 0.1);
+    }
+}
+```
+
+### BEM Methodology Implementation
+
+Use BEM (Block Element Modifier) consistently for all component styling:
+
+- **Block**: `.component-name` - The standalone component
+- **Element**: `.component-name__element` - A part of the component
+- **Modifier**: `.component-name--modifier` or `.component-name__element--modifier` - A variant or state
+
+#### Vue Template BEM Patterns:
+
+```vue
+<template>
+    <!-- Block with modifier -->
+    <article class="card card--featured">
+        <!-- Elements -->
+        <header class="card__header card__header--sticky">
+            <h2 class="card__title">{{ title }}</h2>
+            <button class="card__action card__action--primary">Action</button>
+        </header>
+
+        <div class="card__body">
+            <!-- Combine BEM with lab-ui utilities -->
+            <p class="card__text color-4 font-400">{{ content }}</p>
+        </div>
+
+        <!-- Conditional modifiers -->
+        <footer
+            class="card__footer"
+            :class="{ 'card__footer--expanded': isExpanded }"
+        >
+            <slot name="footer" />
+        </footer>
+    </article>
+</template>
+```
+
+### Lab-UI Utility Integration
+
+Combine BEM component styles with lab-ui utilities for optimal performance:
+
+#### Layout Utilities:
+
+```vue
+<template>
+    <div class="dashboard-grid grid grid--gutters">
+        <div class="dashboard-card grid__6/12 tablet:grid__12/12">
+            <!-- Card content -->
+        </div>
+        <div class="dashboard-card grid__6/12 tablet:grid__12/12">
+            <!-- Card content -->
+        </div>
+    </div>
+</template>
+```
+
+#### Responsive Design:
+
+```vue
+<template>
+    <nav class="main-nav flex justify-between items-center p-2">
+        <div class="main-nav__brand">
+            <img
+                src="logo.svg"
+                alt="Brand"
+                class="logo--small tablet:logo--medium"
+            />
+        </div>
+
+        <div class="main-nav__menu hidden tablet:block">
+            <!-- Desktop menu -->
+        </div>
+
+        <button class="main-nav__toggle block tablet:hidden">
+            <!-- Mobile menu toggle -->
+        </button>
+    </nav>
+</template>
+```
+
+### Component Development Workflow
+
+1. **Create Vue Component**: Focus on structure and behavior only
+2. **Define BEM Classes**: Use semantic class names following BEM methodology
+3. **Create SASS File**: Add corresponding file in `resources/sass/components/`
+4. **Import in General**: Add new component to `resources/sass/general.scss`
+5. **Use Lab-UI Utilities**: Leverage existing utilities before writing custom CSS
+6. **Test Responsively**: Verify component works across all breakpoints
+
 ### Vue Component Patterns
 
 - Use Vue 3 Composition API when appropriate
 - Follow Single File Component (SFC) structure
 - Utilize global components (`GIcon`, `GSvg`) for consistent UI
+- Never include styling within component files
 
 ### Adding New Routes
 
-1. Create component in [`_Build/vue/routes/`](_Build/vue/routes/)
-2. Add route definition to [`_Build/js/libs/routes.js`](_Build/js/libs/routes.js)
+1. Create component in [`resources/vue/routes/`](resources/vue/routes/)
+2. Add route definition to [`resources/js/libs/routes.js`](resources/js/libs/routes.js)
 3. Set `prerender: false` if route shouldn't be pre-rendered
+4. Create corresponding SASS file in [`resources/sass/components/`](resources/sass/components/) if custom styling needed
+
+### Performance Considerations
+
+#### SASS Architecture Benefits:
+
+- **Vendor Caching**: Third-party libraries in `vendor.scss` are cached for faster rebuilds
+- **Fast Recompilation**: Project styles in `general.scss` recompile quickly during development
+- **PurgeCSS Optimization**: Unused CSS automatically removed in production builds
+- **No Style Duplication**: Global SASS architecture prevents style repetition across components
+
+#### PurgeCSS and Dynamic Classes:
+
+```javascript
+// If Vue components add classes dynamically via JavaScript:
+export default {
+    methods: {
+        highlightElement() {
+            // Ensure these classes are preserved in production
+            this.$el.classList.add("highlighted", "animated-in");
+        },
+    },
+};
+```
+
+Add protection in SASS file:
+
+```scss
+/* purgecss start ignore */
+.highlighted,
+.animated-in {
+    // These classes will be preserved in production builds
+}
+/* purgecss end ignore */
+```
+
+### Styling Anti-Patterns to Avoid
+
+❌ **Never do this:**
+
+```vue
+<template>
+    <div class="my-component">
+        <p :style="{ color: dynamicColor }">Text</p>
+    </div>
+</template>
+
+<style scoped>
+.my-component {
+    padding: 20px;
+}
+</style>
+```
+
+✅ **Do this instead:**
+
+```vue
+<template>
+    <div class="my-component" :class="colorClass">
+        <p class="my-component__text">Text</p>
+    </div>
+</template>
+
+<script>
+export default {
+    computed: {
+        colorClass() {
+            return `my-component--${this.variant}`;
+        },
+    },
+};
+</script>
+<!-- Styles in resources/sass/components/_my-component.scss -->
+```
 
 ### Adding Dependencies
 
@@ -230,10 +518,24 @@ The `fw` command is our container orchestration manager that:
 
 1. Always assume containerized environment with `fw` prefix
 2. Follow Vue.js 3 best practices and Composition API patterns
-3. Use existing global components and utilities from lab-ui
-4. Consider the Handlebars template system for static content
-5. Respect the existing SASS architecture and variable system
-6. Ensure new routes are properly configured for SPA routing
-7. Use the existing testing patterns for unit and integration tests
-
-Remember: This is a containerized Vue.js SPA with a custom build system - all operations must go through the `fw` container orchestration manager.
+3. **NEVER suggest `<style>` blocks in Vue components** - All styling goes in SASS files
+4. Use BEM methodology for component class naming (`.block__element--modifier`)
+5. Combine lab-ui utilities with custom component styles for optimal performance
+6. Create corresponding SASS files in `resources/sass/components/` for new components
+7. Import new component styles in `resources/sass/general.scss` for fast recompilation
+8. Use existing global components and utilities from lab-ui
+9. Consider the Handlebars template system for static content
+10. Respect the existing SASS architecture and variable system
+11. Ensure new routes are properly configured for SPA routing
+12. Use the existing testing patterns for unit and integration tests
+13. Always test production builds when adding JavaScript-generated CSS classes (PurgeCSS considerations)
+
+### Key Styling Principles:
+
+- **Separation of Concerns**: Vue handles logic/templates, SASS handles all styling
+- **Utility-First**: Use lab-ui utilities before writing custom CSS
+- **BEM Methodology**: Consistent class naming for maintainable styles
+- **Performance**: Leverage vendor/general file split for optimal build times
+- **Responsive**: Mobile-first design with lab-ui breakpoint system
+
+Remember: This is a containerized Vue.js SPA with structured SASS architecture - all operations must go through the `fw` container orchestration manager, and all styling must be managed through the SASS system using BEM methodology.

package/bitbucket-pipelines.yml

@@ -127,7 +127,9 @@ pipelines:
             - production
           size: 4x
           script:
-            # Install deps
+            # Install lib deps
+            - git submodule init && git submodule update
+            # Install release deps
             - npm install -g semantic-release@24 @semantic-release/changelog@6 @semantic-release/git@10 conventional-changelog-conventionalcommits@8
             # Release version via node so can exit out when no release made
             - |

package/core/1/CHANGELOG.md

@@ -0,0 +1,136 @@
+## Changelog
+
+### 1.8.0 (2025-08-10)
+
+#### Features
+
+* new env flag for remote browsers ([f313be6](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/f313be6cde14e05ac832b43127b6c5639fd62015))
+
+### 1.8.0-beta.1 (2025-08-10)
+
+#### Features
+
+* new env flag for remote browsers ([f313be6](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/f313be6cde14e05ac832b43127b6c5639fd62015))
+
+### 1.7.2 (2025-05-15)
+
+#### Bug Fixes
+
+* use n flag in symlink to override if symlink already exists ([cdc1a41](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/cdc1a41639785f65e2076477f33e86a8ea8cb8fa))
+
+### 1.7.2-beta.1 (2025-05-15)
+
+#### Bug Fixes
+
+* use n flag in symlink to override if symlink already exists ([cdc1a41](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/cdc1a41639785f65e2076477f33e86a8ea8cb8fa))
+
+### 1.7.1 (2025-05-15)
+
+#### Reverts
+
+* Revert "feat: installed husky npm module globally" ([91cc456](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/91cc4564ea2fd6650924732a2a75cb4a9fb749b5))
+
+### 1.7.1-beta.1 (2025-05-14)
+
+#### Reverts
+
+* Revert "feat: installed husky npm module globally" ([91cc456](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/91cc4564ea2fd6650924732a2a75cb4a9fb749b5))
+
+### 1.7.0 (2025-05-14)
+
+#### Features
+
+* installed husky npm module globally ([e08f5a7](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/e08f5a7850d0743137c26addf694f586c8c8ee74))
+* updated node from 20 to 22 ([e592f6e](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/e592f6e93fc6554227f8902c8c1c21a3564a32ce))
+
+### 1.7.0-beta.1 (2025-05-14)
+
+#### Features
+
+* installed husky npm module globally ([e08f5a7](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/e08f5a7850d0743137c26addf694f586c8c8ee74))
+* updated node from 20 to 22 ([e592f6e](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/e592f6e93fc6554227f8902c8c1c21a3564a32ce))
+
+### 1.6.0 (2024-10-22)
+
+#### Features
+
+* own global node_modules folder so local modules can be linked ([82f84fa](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/82f84faa5dfa7c009458bec4fe3a9f2b437c34bf))
+
+### 1.5.2 (2024-10-08)
+
+#### Bug Fixes
+
+* rclone in alpine image and aws sdk back in full image as rclone used for s3 content ([9e68463](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/9e684631bb83c105aa9e5407e8fee30a788309cd))
+
+### 1.5.1 (2024-10-07)
+
+#### Bug Fixes
+
+* move aws from full image to alpine now that s3 content requests are supported ([a947817](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/a94781756ea482545b63018e72ab30ce25727af9))
+
+### 1.5.0 (2024-10-01)
+
+#### Features
+
+* commit into lab-env and create pull request against development on publish ([22e9c66](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/22e9c666dff1e6453090da472a6cd4f0b89c6fbb))
+
+#### Bug Fixes
+
+* close source branch by default on pull request ([5208373](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/5208373822272c648a547f9b328720cb4fdf9bd4))
+
+### 1.4.2 (2024-10-01)
+
+#### Bug Fixes
+
+* trigger ci ([301d679](https://bitbucket.org/fishawackdigital/lab-env-core-1/commits/301d6795162f0bf8941a3b9413a30092a3e8bf21))
+
+### 1.4.1 (2024-07-17)
+* [fix] set global var for git across file system so git avail in mounted volumes i.e node_modules
+
+### 1.4.0 (2024-06-04)
+* [feat] bumped node from 18 to 20
+
+### 1.3.3 (2024-02-09)
+* [fix] symlink wine64 now htat wine is the default global command but electron expects wine64
+
+### 1.3.2 (2024-01-24)
+* [fix] install latest eb cli and use node images python rather than pyenv
+
+### 1.3.1 (2024-01-22)
+* [fix] rebuild of image to get the latest chromium version to fix new puppeteer headless mode
+
+### 1.3.0 (2023-03-17)
+* [feat] node user is now added to www-data group for easier file permission management
+* [fix] disable npm message about update being available
+
+### 1.2.2 (2023-02-25)
+* [fix] set BRANCH and CI_COMMIT_REF_NAME env variables in container
+* [fix] installed git-branch to fetch the current branch for deployment targets
+* [refactor] moved global node module symlinking to alpine image for future use
+
+### 1.2.1 (2023-02-25)
+* [fix] install eb cli into root of image rather than root user directory
+* [perf] dont recurse and dont change group of node_modules to speed up command
+* [refactor] set node git flag without switching user directly in dockerfile
+
+### 1.1.4 (2023-02-23)
+* [Fix] Installed missing are-you-es5 global npm module
+* [Fix] Installed missing check-dependencies global npm module
+
+### 1.1.3 (2023-02-23)
+* [Fix] Switch to ENV for $PATH updates to avoid shell profile loading issues
+* [Fix] Moved chromium to alpine image as its needed for svg tasks and testing
+
+### 1.1.2 (2023-02-22)
+* [Fix] cd into $PWD after su command or we'll start in users home directory
+
+### 1.1.1 (2023-02-22)
+* [Fix] Use -l login flag for su command for both non interactive and interactive shells
+* [Fix] Switch $PATH writes to .profile so they are executed on non interactive shells
+
+### 1.1.0 (2023-02-22)
+* [Feature] Watertight now baked into image so not needed in package.json of projects
+* [Fix] lftp installed in alpine image as it's needed for content tasks
+
+### 1.0.0 (2023-02-21)
+* [Misc] initial commit

package/core/1/Dockerfile

@@ -0,0 +1,113 @@
+#####
+# Alpine image
+#####
+
+FROM node:22 AS alpine
+
+LABEL org.opencontainers.image.authors="Mike Mellor <mike.mellor@avalerehealth.com>"
+
+ARG TARGETARCH
+
+WORKDIR /app
+
+EXPOSE 3000
+EXPOSE 3001
+
+# Get latest apt-get
+RUN apt-get update
+
+# Update npm to latest
+RUN npm install -g npm@latest
+
+# Install dart sass vm (arch switch)
+RUN curl -L -o /sass.tar.gz https://github.com/sass/dart-sass/releases/download/1.57.1/dart-sass-1.57.1-linux-$(if [ "$TARGETARCH" = "arm64" ]; then echo 'arm64'; else echo 'x64'; fi).tar.gz
+RUN tar -xf /sass.tar.gz -C /
+ENV PATH="${PATH}:/dart-sass/"
+RUN rm -rf /sass.tar.gz
+
+# Set safe directory to remove intel errors when running git rev-parse
+RUN su node -c "git config --global --add safe.directory /app"
+
+# Also set global git flag for allowing access across filesystems for mounted node_modules dir
+ENV GIT_DISCOVERY_ACROSS_FILESYSTEM=1
+
+# Disable npm message about updates being available
+RUN su node -c "npm config set update-notifier false"
+
+# Add node user to www-data group
+RUN usermod -a -G www-data node
+
+# Install lftp
+RUN apt-get install -y lftp
+
+# Install chromium
+RUN apt-get install -y chromium fonts-ipafont-gothic fonts-wqy-zenhei fonts-thai-tlwg fonts-kacst fonts-freefont-ttf libxss1 --no-install-recommends
+# Stop Puppeteer downloading browsers during npm install
+ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true
+ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
+
+# Install package.json checker
+RUN npm install check-dependencies -g
+
+# Install node_modules checker
+RUN npm install are-you-es5 -g
+
+# Install git branch fetcher
+RUN npm install git-branch -g
+
+# Link root global node_modules to ~/.node_modules
+RUN ln -s /usr/local/lib/node_modules/ /home/node/.node_modules
+
+# Install rclone
+RUN curl https://rclone.org/install.sh | bash
+
+# Cleanup apt-get install folders
+RUN apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
+
+COPY entrypoint.sh /bin/entrypoint.sh
+RUN chmod +x /bin/entrypoint.sh
+ENTRYPOINT ["/bin/entrypoint.sh"]
+
+#####
+# Full image
+#####
+
+FROM alpine AS full
+
+# Get latest apt-get
+RUN apt-get update
+
+# Install ghostscript
+RUN apt-get install -y ghostscript
+
+# Install zip
+RUN apt-get install zip
+
+# Install AWS Elastic Beanstalk cli
+ENV PATH="${PATH}:/.ebcli-virtual-env/executables"
+RUN apt-get -y install python-is-python3 python3-pip && \
+    pip install virtualenv --break-system-packages && \
+    git clone https://github.com/aws/aws-elastic-beanstalk-cli-setup.git ~/aws-eb && \
+    python ~/aws-eb/scripts/ebcli_installer.py --location / && \
+    rm -rf ~/aws-eb
+
+# Install AWS-CLI@2 (arch switch)
+RUN curl "https://awscli.amazonaws.com/awscli-exe-linux-$(if [ "$TARGETARCH" = "arm64" ]; then echo 'aarch64'; else echo 'x86_64'; fi).zip" -o "awscliv2.zip"
+RUN unzip awscliv2.zip
+RUN ./aws/install
+RUN rm -rf ./aws && rm -rf awscliv2.zip
+
+# Update electron globally
+RUN npm install -g electron-packager@latest
+
+# Install wine64
+RUN apt-get install -y wine64 && \
+    ln -s /usr/bin/wine /usr/bin/wine64
+
+# Install watertight
+RUN --mount=type=ssh npm install -g git+ssh://git@bitbucket.org/fishawackdigital/watertight-node-auto.git#v6.0.0
+
+# Cleanup apt-get install folders
+RUN apt-get clean && \
+    rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

package/core/1/README.md

@@ -0,0 +1,9 @@
+## Background
+
+### What
+
+The image used for core@8 and above.
+
+### Why
+
+Allows us to automate the local developer & CI environments.

package/core/1/bitbucket-pipelines.yml

@@ -0,0 +1,82 @@
+definitions:
+  services:
+    docker:
+      image: docker:dind
+      memory: 12288
+
+pipelines:
+  branches:
+    master:
+      - step:
+          image: fishawack/aws-runner
+          runs-on:
+            - self.hosted
+            - linux
+            - production
+          size: 4x
+          script:
+            # Install release deps
+            - npm install -g semantic-release@24 @semantic-release/changelog@6 @semantic-release/git@10 conventional-changelog-conventionalcommits@8
+            # Release version via node so can exit out when no release made
+            - |
+              node -e "const spawn = require('child_process').spawn('semantic-release', ['--repositoryUrl', 'https://$GIT_CREDENTIALS@bitbucket.org/$BITBUCKET_REPO_FULL_NAME'], { env: { ...process.env, FORCE_COLOR: true } }); spawn.stderr.on('data', d => process.stderr.write(d.toString())); spawn.stdout.on('data', d => {process.stdout.write(d.toString()); if(d.toString().includes('There are no relevant changes, so no new version is released.') || d.toString().includes('therefore a new version won\'t be published.')){process.exit(1);}})" || exit 0
+            # Copy ssh keys so physical files exist for agent to use
+            - cp /build/*/ssh/* ~/.ssh/
+            # Start ssh agent and add all (if any) keys
+            - eval `ssh-agent` && ssh-add || true
+            # Publish docker image
+            - docker login $DOCKER_CREDENTIALS && docker buildx create --use && npm run image
+            # Sync beta after publish
+            - git config --global user.email "digital@fishawack.com"
+            - git config --global user.name "Digital Fishawack"
+            - git fetch origin "+refs/heads/*:refs/remotes/origin/*" && git checkout beta && git merge master && git push origin beta
+            # Commit and create pull request for new version on lab-env repo
+            - git clone https://$GIT_CREDENTIALS@bitbucket.org/fishawackdigital/lab-env
+            - cd lab-env
+            - git checkout -b "$BITBUCKET_REPO_SLUG-$BITBUCKET_COMMIT" origin/beta
+            - git submodule init
+            - git submodule update
+            - git submodule update --remote --merge core/1
+            - git add .
+            - |
+              git commit --allow-empty -m "build(core/1): Bumped $BITBUCKET_REPO_SLUG"
+            - git push origin "$BITBUCKET_REPO_SLUG-$BITBUCKET_COMMIT"
+            - |
+              curl https://api.bitbucket.org/2.0/repositories/fishawackdigital/lab-env/pullrequests \
+                -u $GIT_CREDENTIALS \
+                --header 'Content-Type: application/json' \
+                --data "{
+                  \"title\": \"Bumped $BITBUCKET_REPO_SLUG\",
+                  \"destination\": {
+                    \"branch\": {
+                      \"name\": \"beta\"
+                    }
+                  },
+                  \"source\": {
+                    \"branch\": {
+                      \"name\": \"$BITBUCKET_REPO_SLUG-$BITBUCKET_COMMIT\"
+                    }
+                  },
+                  \"reviewers\": [
+                      {
+                          \"uuid\": \"{2518e4c3-fc1d-4653-b355-c00be099ce6c}\"
+                      }
+                  ],
+                  \"close_source_branch\": true
+                }"
+          services:
+            - docker
+    beta:
+      - step:
+          image: fishawack/aws-runner
+          runs-on:
+            - self.hosted
+            - linux
+            - production
+          size: 4x
+          script:
+            # Install deps
+            - npm install -g semantic-release@24 @semantic-release/changelog@6 @semantic-release/git@10 conventional-changelog-conventionalcommits@8
+            # Release version via node so can exit out when no release made
+            - |
+              node -e "const spawn = require('child_process').spawn('semantic-release', ['--repositoryUrl', 'https://$GIT_CREDENTIALS@bitbucket.org/$BITBUCKET_REPO_FULL_NAME'], { env: { ...process.env, FORCE_COLOR: true } }); spawn.stderr.on('data', d => process.stderr.write(d.toString())); spawn.stdout.on('data', d => {process.stdout.write(d.toString()); if(d.toString().includes('There are no relevant changes, so no new version is released.') || d.toString().includes('therefore a new version won\'t be published.')){process.exit(1);}})" || exit 0

package/core/1/docker-compose.yml

@@ -0,0 +1,37 @@
+services:
+  core:
+    build:
+      context: $FW_CORE_1_CONTEXT
+      target: $FW_CORE_1_TARGET
+      ssh:
+        - default
+      args:
+        target: $FW_CORE_1_TARGET
+        target_image: $FW_CORE_1_TARGET_IMAGE
+    image: $FW_CORE_1_IMAGE:${FW_CORE_1_VERSION:-latest}
+    init: true
+    tty: true
+    volumes:
+      - $CWD/:/app
+      - $FW_DIR/targets:/home/node/targets
+      - $FW_DIR/.ssh:/home/node/.ssh
+      - $FW_DIR/.aws:/home/node/.aws
+      - node_modules:/app/node_modules
+    ports:
+      - ${PORT:-3000}:${PORT:-3000}
+      - ${PORT_OPT:-3001}:${PORT_OPT:-3001}
+    environment:
+      - REPO=${REPO:-}
+      - PORT=${PORT:-3000}
+      - PORT_OPT=${PORT_OPT:-3001}
+      - PORT_WEB=${PORT_WEB:-8000}
+      - PORT_DB=${PORT_DB:-3306}
+      - USER_UID=${USER_UID:-0}
+      - USER_GID=${USER_GID:-0}
+      - FW_ROOT=${FW_ROOT:-}
+      - BRANCH=${BRANCH:-}
+      - CI_COMMIT_REF_NAME=${CI_COMMIT_REF_NAME:-}
+      - REMOTE_BROWSERS=${REMOTE_BROWSERS:-chrome}
+volumes:
+  node_modules:
+    driver: "local"

package/core/1/entrypoint.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+# Setting $FW_ROOT will bypass the user switch to node
+if [ -z "$FW_ROOT" ]; then
+    # Set node user id to match host users id so no permission issues outside of docker
+    usermod -u $USER_UID node &>/dev/null
+
+    # Own the node_modules folder otherwise it'll be owned by root/previous node id which will prevent writing
+    chown node /app/node_modules
+
+    # Own the global node_modules folder otherwise it'll be owned by root/previous node id which will prevent writing
+    chown node /usr/local/lib/node_modules
+
+    # Default arguments will always be bash -l, if nothing follows this just start an non login interactive shell
+    if [ -z "${@:3}" ]; then
+        exec su node
+    # Otherwise pipe the command after the bash -lc into the non login non interactive shell as a command to exec
+    else
+        exec su node -c "${@:3}"
+    fi
+else
+    echo "Accessing as root"
+    exec "$@"
+fi

package/core/1/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "core",
+    "version": "1.8.0",
+    "description": "lab-env docker config for the @fishawack/core/1 npm module",
+    "scripts": {
+        "setup": "ln -sfn ../../.commitlintrc.json .commitlintrc.json && ln -sfn ../../.editorconfig .editorconfig && ln -sfn ../../.prettierignore .prettierignore && ln -sfn ../../.husky/ .husky && husky &>/dev/null || true",
+        "image": "docker buildx build --ssh default --platform linux/amd64,linux/arm64 -t fishawack/lab-env-core-1:$npm_package_version -t fishawack/lab-env-core-1:latest --push . && docker buildx build --ssh default --target alpine --platform linux/amd64,linux/arm64 -t fishawack/lab-env-core-1-alpine:$npm_package_version -t fishawack/lab-env-core-1-alpine:latest --push ."
+    },
+    "author": "Mike Mellor",
+    "license": "ISC",
+    "release": {
+        "plugins": [
+            [
+                "@semantic-release/commit-analyzer",
+                {
+                    "preset": "conventionalcommits"
+                }
+            ],
+            [
+                "@semantic-release/release-notes-generator",
+                {
+                    "preset": "conventionalcommits",
+                    "writerOpts": {
+                        "headerPartial": "### {{version}} ({{date}})\n",
+                        "mainTemplate": "{{> header}}\n{{#each commitGroups}}\n\n{{#if title}}\n#### {{title}}\n\n{{/if}}\n{{#each commits}}\n{{> commit root=@root}}\n{{/each}}\n{{/each}}"
+                    },
+                    "presetConfig": {
+                        "commitUrlFormat": "{{host}}/{{owner}}/{{repository}}/commits/{{hash}}"
+                    }
+                }
+            ],
+            [
+                "@semantic-release/changelog",
+                {
+                    "changelogTitle": "## Changelog"
+                }
+            ],
+            [
+                "@semantic-release/npm",
+                {
+                    "npmPublish": false
+                }
+            ],
+            "@semantic-release/git"
+        ]
+    }
+}

package/globals.js

@@ -609,6 +609,7 @@ if (
 }
 
 if (version) {
+    copyAIInstructionsFile("sass-*");
     copyAIInstructionsFile("lab-env-*");
     copyAIInstructionsFile("webdriverio-capture-v9");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fishawack/lab-env",
-    "version": "4.45.0-beta.1",
+    "version": "4.45.0-beta.2",
     "description": "Docker manager for FW",
     "main": "cli.js",
     "scripts": {