Add Node.js Support

docs/nodejs.md

@@ -0,0 +1,29 @@
+# Node.js
+
+Altis supports running Node.js applications alongside WordPress, utilizing WordPress as a headless API.
+
+## Enabling Node.js in Local Server
+
+Node.js can be enabled in Local Server by adding `extra.altis.modules.local-server.nodejs` in the project's `composer.json`
+
+```json
+{
+	"extra": {
+		"altis": {
+			"modules": {
+				"local-server": {
+					"nodejs": {
+            "path": "../altis-nodejs-skeleton",
+            "version": "21.1"
+          }
+				}
+			}
+		}
+	}
+}
+```
+
+`path` refers to the relative path of the project's front-end code.
+`version` refers to the version of Node.js to use
+
+This will make the application available at nodejs-my-project.altis.dev.

inc/composer/class-command.php

@@ -322,6 +322,13 @@
 		$output->writeln( '<info>Startup completed.</>' );
 		$output->writeln( '<info>To access your site visit:</> <comment>' . $site_url . '</>' );
 
+		if (static::get_composer_config()['nodejs'] ?? false) {
+			$tld = $this->get_project_tld();
+			$subdomain = $this->get_project_subdomain();
+			$hostname = $subdomain . '.' . $tld;
+			$output->writeln( '<info>To access your Node.js site visit:</> <comment>https://nodejs-' . $hostname . '</>' );
+		}
+
 		$this->check_host_entries( $input, $output );
 
 		return 0;

inc/composer/class-docker-compose-generator.php

@@ -237,6 +237,53 @@
 		];
 	}
 
+	/**
+	 * Get the NodeJS container service.
+	 *
+	 * @return array
+	 */
+	protected function get_service_nodejs() : array {
+		$config = $this->get_config();
+
+		$version = (string) $this->get_config()['nodejs']['version'] ?? '20';
+
+		return [
+			'nodejs' => [
+				'image' => "node:{$version}-bookworm",
+				'container_name' => "{$this->project_name}-nodejs",
+				'ports' => [
+					'3000',
+				],
+				'volumes' => [
+					"../{$config['nodejs']['path']}/:/usr/src/app"
+				],
+				'working_dir' => '/usr/src/app',
+				'command' => 'npm run dev',
+				'networks' => [
+					'proxy',
+					'default',
+				],
+				'healthcheck' => [
+					'test' => [
+						'CMD-SHELL',
+						'curl --silent --fail localhost:3000 || exit 1',
+					],
+					'interval' => '5s',
+					'timeout' => '5s',
+					'retries' => 25,
+				],
+				'labels' => [
+					'traefik.frontend.priority=1',
+					'traefik.port=3000',
+					'traefik.protocol=http',
+					'traefik.docker.network=proxy',
+					"traefik.frontend.rule=HostRegexp:nodejs-{$this->hostname}",
+					"traefik.domain=nodejs-{$this->hostname}",
+				],
+			]
+		];
+	}
+
 	/**
 	 * Webgrind service container for viewing Xdebug profiles.
 	 *
@@ -813,6 +860,10 @@
 			$services = array_merge( $services, $this->get_service_webgrind() );
 		}
 
+		if ( $this->get_config()['nodejs'] ) {
+			$services = array_merge( $services, $this->get_service_nodejs() );
+		}
+
 		// Default compose configuration.
 		$config = [
 			// 'version' => '2.5',
@@ -914,6 +965,7 @@
 			'ignore-paths' => [],
 			'php' => '8.1',
 			'mysql' => '8.0',
+			'nodejs' => $modules['nodejs'] ?? false,
 		];
 
 		return array_merge( $defaults, $modules['local-server'] ?? [] );