flagon-io/detect

public

Says what a g1t.page build of this checkout would find, without building anything. Its kind and framework, how it installs, what builds it and where its output is.

Compare changes

Choose two branches to see what one has that the other does not, then open a pull request for it.

1 commit

A deployment is a site or a Worker whenever it can be, and a container only as the fallback. With Build as on Auto, a Wrangler config or a framework's Cloudflare adapter is a Workers project; a framework's site, a build script's or an index.html is that site even beside a Dockerfile, and the log says "Built as a Vite site; Dockerfile is not used (a container is only the fallback; choose **Build as**: Container to use it)", where a Dockerfile that ran a server used to win; a Node.js server with no Dockerfile (Express, Koa, Hono, Polka, Restify, hapi, node:http) runs as a Worker; any other server g1t recognises, a Node.js server with its own Dockerfile, a framework set up to need a server, or a Dockerfile with nothing else to serve is a container.syntaqx18c93d9yesterday

24	24		\| `root-dir` \| The checkout \| Where the project is in the checkout. \|
25	25		\| `build-command` \| None \| A build command of your own, as `g1t/deploy` takes it. \|
26	26		\| `output-dir` \| None \| An output folder of your own, as `g1t/deploy` takes it. \|
27		−	\| `build-as` \| `auto` \| What it is built as: `auto`, `static`, `workers` or `docker`, as `g1t/deploy` takes it. \|
	27	+	\| `build-as` \| `auto` \| What it is built as: `auto`, `static`, `workers` or `docker` (Container), as `g1t/deploy` takes it. \|
28	28		\| `dockerfile` \| None \| A Dockerfile's path of your own, as `g1t/deploy` takes it. \|
29	29
30	30		## Outputs
31	31
32	32		\| Output \| \|
33	33		\| --- \| --- \|
34		−	\| `kind` \| `workers` (a `wrangler.jsonc`, `wrangler.json` or `wrangler.toml`, or a framework's Cloudflare adapter), `static` (a site a build writes), `html` (the files as they are), `container` (a `Dockerfile`, a framework set up to need a server, or a server g1t writes a Dockerfile for) or `none` (nothing to serve). \|
35		−	\| `framework` \| The framework it is built with, from the table below; for a container without one, `dockerfile`, or the server g1t writes a Dockerfile for (`node`, `django`, `flask`, `fastapi`, `python`, `go`, `rails`, `rack`, `laravel`, `php`). Empty when there is none. \|
	34	+	\| `kind` \| `workers` (a `wrangler.jsonc`, `wrangler.json` or `wrangler.toml`, a framework's Cloudflare adapter, or a Node.js server run as a Worker), `static` (a site a build writes), `html` (the files as they are), `container` (a server that is not run as a Worker, a framework set up to need a server, or a `Dockerfile` with nothing else to serve) or `none` (nothing to serve). \|
	35	+	\| `framework` \| The framework it is built with, from the table below; `node` for a Node.js server run as a Worker; for a container without one, `dockerfile`, or the server g1t writes a Dockerfile for (`node`, `django`, `flask`, `fastapi`, `python`, `go`, `rails`, `rack`, `laravel`, `php`). Empty when there is none. \|
36	36		\| `dockerfile` \| A container's own Dockerfile, relative to the project. Empty when g1t writes one, and for anything that is not a container. \|
37	37		\| `port` \| The port a container listens on: its Dockerfile's `EXPOSE`, else `8080`. \|
	38	+	\| `entry` \| For a Node.js server run as a Worker, the file that starts it, relative to the project. Empty for anything else. \|
38	39		\| `install` \| How dependencies are installed, from the lockfile: `npm ci`, `pnpm install --frozen-lockfile`, and so on, and `bundle install` for Jekyll. Empty when there is nothing to install. \|
39	40		\| `build` \| What builds it: your command, the package's `build` script (`npm run build`), the framework's own command, or `wrangler deploy --dry-run` for Workers. Empty when nothing does. \|
40	41		\| `output-dir` \| The folder served, relative to the project (`.` for the project itself): yours, a Workers project's assets directory, the folder the framework writes, or the first of `dist`, `build`, `out`, `public`, `_site`, `.output/public` that exists. Empty when a build has yet to write it, as for a Cloudflare adapter's Worker. \|

26	26
27	27		outputs:
28	28		kind:
29		−	description: workers (a Wrangler config, or a framework's Cloudflare adapter), static (a site a build writes), html (the files as they are), container (a Dockerfile, a framework set up to need a server, or a server g1t writes a Dockerfile for) or none (nothing to serve).
	29	+	description: workers (a Wrangler config, a framework's Cloudflare adapter, or a Node.js server run as a Worker), static (a site a build writes), html (the files as they are), container (a server that is not run as a Worker, a framework set up to need a server, or a Dockerfile with nothing else to serve) or none (nothing to serve).
30	30		value: ${{ steps.detect.outputs.kind }}
31	31		install:
32	32		description: How its dependencies are installed, such as npm ci. Empty without a package.json.
⋯
38	38		description: The folder that is served, relative to the project (. for the project itself). Empty when a build has yet to write it.
39	39		value: ${{ steps.detect.outputs.output-dir }}
40	40		framework:
41		−	description: The framework it is built with, such as vite, astro, nextjs, sveltekit or hugo; for a container without one, dockerfile or the server g1t writes a Dockerfile for (node, flask, rails…). Empty when there is none.
	41	+	description: The framework it is built with, such as vite, astro, nextjs, sveltekit or hugo; node for a Node.js server run as a Worker; for a container without one, dockerfile or the server g1t writes a Dockerfile for (node, flask, rails…). Empty when there is none.
42	42		value: ${{ steps.detect.outputs.framework }}
43	43		dockerfile:
44	44		description: A container's own Dockerfile, relative to the project. Empty when g1t writes one, or for anything else.
⋯
46	46		port:
47	47		description: The port a container listens on, its Dockerfile's EXPOSE or 8080. Empty for anything else.
48	48		value: ${{ steps.detect.outputs.port }}
	49	+	entry:
	50	+	description: For a Node.js server run as a Worker, the file that starts it, relative to the project. Empty for anything else.
	51	+	value: ${{ steps.detect.outputs.entry }}
49	52
50	53		runs:
51	54		using: composite