feat(starters): add htmx+go and fix go starter

• Added the HTMX + Go starter with a Go-rendered page, HTMX fragment endpoint, refresh-button with swap, agent support, CLI metadata, starter archive wiring, docs updates, and HTMX logo
• Fixed the existing Go starter by correcting bad Elements bundle URLs, loading CSS and JS from the right packages, removing the frontend dependency/setup path, fixing stale copy, updating source links, simplifying template data
• More Go server functionality with PORT support, root-only routing, explicit HTML content type, and template execution error handling.
• Go and HTMX+Go frontend build tooling removed, now using browser CDN bundles, excluding local build/cache outputs, skipping Elements dependency setup, and stamping CDN bundle versions during archive generation.
• Test updates including Elements version stamping logic
Signed-off-by: Jake Guza <jguza@nvidia.com>

Author: jguzanvidia

.github/actions/setup-ci/action.yml

@@ -13,6 +13,10 @@ runs:
 node-version-file: './.nvmrc'
 registry-url: 'https://registry.npmjs.org'
 cache: 'pnpm'
+ - uses: actions/setup-go@v6
+with:
+go-version: '1.26.x'
+cache: false
  - name: Install dependencies
 shell: bash
 run: pnpm install --frozen-lockfile

.prettierignore

@@ -30,6 +30,7 @@ projects/starters/bundles/src/index.html
 projects/starters/eleventy/src/_layouts/index.11ty.js
 projects/starters/eleventy/src/index.11ty.js
 projects/starters/go/src/index.html
+projects/starters/go-htmx/src/index.html
 projects/starters/hugo/**/*
 projects/starters/importmaps/src/index.html
 projects/starters/mpa/src/**/*.html
@@ -39,4 +40,4 @@ projects/starters/solidjs/src/App.tsx
 projects/starters/typescript/src/index.html
 projects/starters/vue/src/**/*
 projects/starters/nuxt/.nuxt/**/*
-projects/starters/nuxt/app/**/*
+projects/starters/nuxt/app/**/*

README.md

@@ -33,11 +33,14 @@ Examples of projects include:
 
 To set up repository dependencies and run the full build, run the following commands at the **root** of the repository:
 
+The CI pipeline also builds Go starters. Install [Go 1.26.x](https://go.dev/doc/install) before running the full local CI pipeline.
+
 ```shell
 # install required dependencies
 brew install git-lfs
 git lfs install
 git lfs pull
+go version
 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
 .~/.nvm/nvm.sh
 nvm install

package.json

@@ -86,6 +86,8 @@
 "./projects/starters/bundles:ci",
 "./projects/starters/eleventy:ci",
 "./projects/starters/eleventy-ssr:ci",
+"./projects/starters/go:ci",
+"./projects/starters/go-htmx:ci",
 "./projects/starters/hugo:ci",
 "./projects/starters/importmaps:ci",
 "./projects/starters/lit-library:ci",

pnpm-lock.yaml

@@ -6,6 +6,7 @@ packages:
  - projects/starters/eleventy
  - projects/starters/eleventy-ssr
  - projects/starters/go
+ - projects/starters/go-htmx
  - projects/starters/hugo
  - projects/starters/importmaps
  - projects/starters/lit-library

pnpm-workspace.yaml

@@ -15,8 +15,8 @@ vi.mock('./setup-agent.js', () => ({
 vi.mock('./starters.js',()=>({
 startersData: {
 typescript: {cli: true,zip: 'typescript.zip'},
-react: {cli: true,zip: 'react.zip'},
-importmaps: {cli: false,zip: 'importmaps.zip'}
+go: {cli: true,zip: 'go.zip',setupDependencies: false},
+lit: {cli: false,zip: null}
 },
 createStarter: vi.fn(),
 startStarter: vi.fn()
@@ -60,6 +60,25 @@ describe('ProjectService', () => {
 expect(updateProject).toHaveBeenCalled();
 });
 
+it('should skip dependency setup for starters that opt out of project setup',async()=>{
+const{ createStarter }=awaitimport('./starters.js');
+const{ setupAgent }=awaitimport('./setup-agent.js');
+const{ setupProject }=awaitimport('./setup.js');
+const{ updateProject }=awaitimport('./update.js');
+vi.mocked(createStarter).mockResolvedValue({create: {message: 'created',status: 'success'}});
+vi.mocked(setupAgent).mockResolvedValue({agent: {message: 'configured',status: 'success'}});
+
+const{ ProjectService }=awaitimport('./service.js');
+constresult=awaitProjectService.create({type: 'go',cwd: '/test',start: false});
+
+expect(result).toHaveProperty('create');
+expect(result).toHaveProperty('agent');
+expect(createStarter).toHaveBeenCalledWith('go','/test');
+expect(setupAgent).toHaveBeenCalled();
+expect(setupProject).not.toHaveBeenCalled();
+expect(updateProject).not.toHaveBeenCalled();
+});
+
 it('should return failed report when a step fails',async()=>{
 const{ createStarter }=awaitimport('./starters.js');
 const{ setupAgent }=awaitimport('./setup-agent.js');

projects/internals/tools/src/project/service.test.ts

@@ -16,6 +16,11 @@ const starters = Object.keys(startersData).filter(
 starter=>startersData[starteraskeyoftypeofstartersData]?.cli
 )asStarter[];
 
+functionstarterShouldSetupDependencies(type: Starter): boolean{
+conststarterData=startersData[type];
+return!('setupDependencies'instarterData)||starterData.setupDependencies;
+}
+
 @service()
 exportclassProjectService{
  @tool({
@@ -56,9 +61,12 @@ export class ProjectService {
 
 constcreateReport=awaitcreateStarter(type,dir);
 constagentReport=awaitsetupAgent(projectDir,'all');
-constsetupProjectReport=awaitsetupProject(projectDir);
-constupdateReport=awaitupdateProject(projectDir);
-constreports=[createReport,agentReport,setupProjectReport,updateReport];
+constreports=[createReport,agentReport];
+if(starterShouldSetupDependencies(type)){
+constsetupProjectReport=setupProject(projectDir);
+constupdateProjectReport=awaitupdateProject(projectDir);
+reports.push(setupProjectReport,updateProjectReport);
+}
 
 constfailedReport=reports.find(report=>Object.values(report).some(value=>value.status==='danger'));
 if(failedReport){
@@ -69,12 +77,7 @@ export class ProjectService {
 awaitstartStarter(projectDir);
 }
 
-return{
- ...createReport,
- ...agentReport,
- ...setupProjectReport,
- ...updateReport
-};
+returnObject.assign({}, ...reports);
 }
 
  @tool({

projects/internals/tools/src/project/service.ts

@@ -5,11 +5,13 @@ import type * as childProcess from 'node:child_process';
 import{beforeEach,describe,expect,it,vi}from'vitest';
 import{
 startersData,
+createStarterCDNUrl,
 createGitInitProcess,
 createStarterPaths,
 execPackageManager,
 getDependencyInstallFailureMessage,
 getRequiredNPMClient,
+stampStarterCDNVersions,
 removeWireitScripts,
 startStarter
 }from'./starters.js';
@@ -48,6 +50,7 @@ describe('startersData', () => {
 expect(startersData.nextjs.cli).toBe(true);
 expect(startersData.solidjs.cli).toBe(true);
 expect(startersData.go.cli).toBe(true);
+expect(startersData['go-htmx'].cli).toBe(true);
 expect(startersData.hugo.cli).toBe(true);
 expect(startersData.eleventy.cli).toBe(true);
 expect(startersData.bundles.cli).toBe(true);
@@ -66,6 +69,7 @@ describe('startersData', () => {
 expect(startersData.nextjs.zip).toContain('nextjs.zip');
 expect(startersData.solidjs.zip).toContain('solidjs.zip');
 expect(startersData.go.zip).toContain('go.zip');
+expect(startersData['go-htmx'].zip).toContain('go-htmx.zip');
 expect(startersData.eleventy.zip).toContain('eleventy.zip');
 expect(startersData.importmaps.zip).toContain('importmaps.zip');
 expect(startersData.bundles.zip).toContain('bundles.zip');
@@ -198,6 +202,96 @@ describe('getDependencyInstallFailureMessage', () => {
 });
 });
 
+describe('starter CDN URLs',()=>{
+typeStarterCDNPackageName=Parameters<typeofcreateStarterCDNUrl>[0];
+typeStarterCDNAsset={packageName: StarterCDNPackageName;filePath: string};
+
+constversions: Record<StarterCDNPackageName,string>={
+'@nvidia-elements/core': '1.2.3',
+'@nvidia-elements/styles': '4.5.6',
+'@nvidia-elements/themes': '7.8.9'
+};
+
+constcoreAsset: StarterCDNAsset={packageName: '@nvidia-elements/core',filePath: 'dist/bundles/index.min.js'};
+conststylesAsset: StarterCDNAsset={packageName: '@nvidia-elements/styles',filePath: 'dist/bundles/index.css'};
+constthemesAsset: StarterCDNAsset={packageName: '@nvidia-elements/themes',filePath: 'dist/bundles/index.css'};
+constthemeFontsAsset: StarterCDNAsset={packageName: '@nvidia-elements/themes',filePath: 'dist/fonts/inter.css'};
+conststarterCDNAssets=[stylesAsset,themesAsset,themeFontsAsset,coreAsset];
+
+functioncreateVersionedStarterCDNUrl(asset: StarterCDNAsset,version=versions[asset.packageName]){
+returncreateStarterCDNUrl(asset.packageName,version,asset.filePath);
+}
+
+functioncreateUnversionedStarterCDNUrl(asset: StarterCDNAsset){
+returncreateVersionedStarterCDNUrl(asset).replace(
+`${asset.packageName}@${versions[asset.packageName]}`,
+asset.packageName
+);
+}
+
+it('should create versioned CDN URLs',()=>{
+consturl=createVersionedStarterCDNUrl(coreAsset);
+
+expect(newURL(url).protocol).toBe('https:');
+expect(url).toContain(`${coreAsset.packageName}@${versions[coreAsset.packageName]}/${coreAsset.filePath}`);
+});
+
+it('should stamp unversioned Elements CDN URLs with package versions',()=>{
+constcontent=`
+ <link rel="stylesheet" href="${createUnversionedStarterCDNUrl(stylesAsset)}" />
+ <link rel="stylesheet" href="${createUnversionedStarterCDNUrl(themesAsset)}" />
+ <link rel="stylesheet" href="${createUnversionedStarterCDNUrl(themeFontsAsset)}" />
+ <script type="module">
+ import '${createUnversionedStarterCDNUrl(coreAsset)}';
+ </script>
+ `;
+
+constresult=stampStarterCDNVersions(content,versions);
+
+for(constassetofstarterCDNAssets){
+expect(result).toContain(createVersionedStarterCDNUrl(asset));
+}
+});
+
+it('should replace existing Elements CDN versions',()=>{
+constcontent=`
+ <link rel="stylesheet" href="${createVersionedStarterCDNUrl(stylesAsset,'0.0.1')}" />
+ <link rel="stylesheet" href="${createVersionedStarterCDNUrl(themesAsset,'0.0.1')}" />
+ <link rel="stylesheet" href="${createVersionedStarterCDNUrl(themeFontsAsset,'0.0.1')}" />
+ <script type="module">
+ import '${createVersionedStarterCDNUrl(coreAsset,'0.0.1')}';
+ </script>
+ `;
+
+constresult=stampStarterCDNVersions(content,versions);
+
+for(constassetofstarterCDNAssets){
+expect(result).toContain(createVersionedStarterCDNUrl(asset));
+}
+expect(result).not.toContain('@0.0.1/');
+});
+
+it('should leave unrelated CDN URLs unchanged',()=>{
+constunrelatedElementsPackageUrl=createVersionedStarterCDNUrl(coreAsset).replace(
+`${coreAsset.packageName}@${versions[coreAsset.packageName]}/${coreAsset.filePath}`,
+'@nvidia-elements/monaco/dist/bundles/index.css'
+);
+consthtmxUrl=createVersionedStarterCDNUrl(coreAsset).replace(
+`${coreAsset.packageName}@${versions[coreAsset.packageName]}/${coreAsset.filePath}`,
+'htmx.org@2.0.10/dist/htmx.min.js'
+);
+constcontent=`
+ <link rel="stylesheet" href="${unrelatedElementsPackageUrl}" />
+ <script src="${htmxUrl}"></script>
+ `;
+
+constresult=stampStarterCDNVersions(content,versions);
+
+expect(result).toContain(unrelatedElementsPackageUrl);
+expect(result).toContain(htmxUrl);
+});
+});
+
 describe('getNPMClient',()=>{
 it('should return the npm client',async()=>{
 expect(awaitgetNPMClient()).toBe('pnpm');