percher 0.3.0 → 0.4.1

package/dist/templates/laravel/public/index.php

@@ -0,0 +1,37 @@
+<?php
+// Minimal router — swap in Laravel's bootstrap/app.php once you run
+// `composer create-project laravel/laravel .` to upgrade to the full framework.
+
+$uri = parse_url($_SERVER["REQUEST_URI"], PHP_URL_PATH);
+
+if ($uri === "/health") {
+  header("Content-Type: application/json");
+  echo json_encode(["ok" => true]);
+  exit;
+}
+
+if ($uri === "/") {
+  header("Content-Type: text/html; charset=utf-8");
+  echo <<<HTML
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>__APP_NAME__</title>
+    <style>
+      body { font-family: system-ui, sans-serif; max-width: 640px; margin: 48px auto; padding: 0 24px; line-height: 1.6; }
+      h1 { letter-spacing: -0.5px; }
+    </style>
+  </head>
+  <body>
+    <h1>__APP_NAME__</h1>
+    <p>A PHP app deployed on Percher.</p>
+    <p>To upgrade to full Laravel: <code>composer create-project laravel/laravel .</code></p>
+  </body>
+</html>
+HTML;
+  exit;
+}
+
+http_response_code(404);
+echo "Not found";

package/dist/templates/nextjs/app/api/health/route.ts

@@ -0,0 +1,3 @@
+export async function GET() {
+  return Response.json({ status: "ok" });
+}

package/dist/templates/nextjs/app/layout.tsx

@@ -0,0 +1,11 @@
+export const metadata = {
+  title: "__APP_NAME__",
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/dist/templates/nextjs/app/page.tsx

@@ -0,0 +1,10 @@
+export default function Home() {
+  return (
+    <main style={{ fontFamily: "system-ui", padding: "2rem", maxWidth: 600, margin: "0 auto" }}>
+      <h1>__APP_NAME__</h1>
+      <p>
+        Edit <code>app/page.tsx</code> and run <code>bunx percher push</code> to deploy.
+      </p>
+    </main>
+  );
+}

package/dist/templates/nextjs/next.config.ts

@@ -0,0 +1,5 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {};
+
+export default nextConfig;

package/dist/templates/nextjs/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  }
+}

package/dist/templates/nextjs/percher.toml

@@ -0,0 +1,15 @@
+[app]
+name = "__APP_NAME__"
+runtime = "node"
+framework = "nextjs"
+
+[build]
+command = "bun run build"
+output = ".next"
+
+[web]
+port = 3000
+health = "/api/health"
+
+[data]
+mode = "none"

package/dist/templates/node/index.js

@@ -0,0 +1,26 @@
+const http = require("node:http");
+
+const port = Number(process.env.PORT ?? 3000);
+
+const server = http.createServer((req, res) => {
+  const url = new URL(req.url, `http://${req.headers.host}`);
+
+  if (url.pathname === "/health") {
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ status: "ok" }));
+    return;
+  }
+
+  if (url.pathname === "/") {
+    res.writeHead(200, { "Content-Type": "text/plain" });
+    res.end("Hello from __APP_NAME__!");
+    return;
+  }
+
+  res.writeHead(404, { "Content-Type": "text/plain" });
+  res.end("Not found");
+});
+
+server.listen(port, "0.0.0.0", () => {
+  console.log(`[__APP_NAME__] listening on http://0.0.0.0:${port}`);
+});

package/dist/templates/node/index.ts

@@ -0,0 +1,12 @@
+const server = Bun.serve({
+  port: Number(process.env.PORT ?? 3000),
+  fetch(req) {
+    const url = new URL(req.url);
+    if (url.pathname === "/health") {
+      return Response.json({ status: "ok" });
+    }
+    return new Response("Hello from __APP_NAME__!");
+  },
+});
+
+console.log(`Listening on http://localhost:${server.port}`);

package/dist/templates/node/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "start": "node index.js"
+  }
+}

package/dist/templates/node/percher.toml

@@ -0,0 +1,10 @@
+[app]
+name = "__APP_NAME__"
+runtime = "node"
+
+[web]
+port = 3000
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/nuxt/app.vue

@@ -0,0 +1,6 @@
+<template>
+  <main style="font-family: system-ui; padding: 40px;">
+    <h1>Hello from __APP_NAME__</h1>
+    <p>Nuxt 3 on Percher. Edit <code>app.vue</code> or add pages under <code>pages/</code>.</p>
+  </main>
+</template>

package/dist/templates/nuxt/nuxt.config.ts

@@ -0,0 +1,4 @@
+export default defineNuxtConfig({
+  compatibilityDate: "2025-01-01",
+  devtools: { enabled: true },
+});

package/dist/templates/nuxt/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "nuxt build",
+    "dev": "nuxt dev",
+    "start": "node .output/server/index.mjs"
+  },
+  "devDependencies": {
+    "nuxt": "^3.13.0",
+    "vue": "^3.4.0"
+  }
+}

package/dist/templates/nuxt/percher.toml

@@ -0,0 +1,15 @@
+[app]
+name = "__APP_NAME__"
+runtime = "node"
+framework = "nuxt"
+
+[build]
+command = "bun run build"
+output = ".output"
+
+[web]
+port = 3000
+health = "/api/health"
+
+[data]
+mode = "none"

package/dist/templates/nuxt/server/api/health.ts

@@ -0,0 +1 @@
+export default defineEventHandler(() => ({ status: "ok" }));

package/dist/templates/phoenix/Dockerfile

@@ -0,0 +1,15 @@
+FROM elixir:1.17-alpine
+WORKDIR /app
+RUN apk add --no-cache build-base \
+ && addgroup -S app && adduser -S app -G app \
+ && mkdir -p /home/app/.mix \
+ && chown -R app:app /home/app /app
+USER app
+RUN mix local.hex --force && mix local.rebar --force
+COPY --chown=app:app mix.exs ./
+RUN mix deps.get
+COPY --chown=app:app . .
+RUN mix compile
+ENV PORT=4000
+EXPOSE 4000
+CMD ["mix", "run", "--no-halt"]

package/dist/templates/phoenix/lib/application.ex

@@ -0,0 +1,15 @@
+defmodule PercherApp.Application do
+  use Application
+
+  @impl true
+  def start(_type, _args) do
+    port = String.to_integer(System.get_env("PORT") || "4000")
+
+    children = [
+      {Bandit, plug: PercherApp.Router, port: port}
+    ]
+
+    opts = [strategy: :one_for_one, name: PercherApp.Supervisor]
+    Supervisor.start_link(children, opts)
+  end
+end

package/dist/templates/phoenix/lib/router.ex

@@ -0,0 +1,39 @@
+defmodule PercherApp.Router do
+  use Plug.Router
+
+  plug(:match)
+  plug(:dispatch)
+
+  get "/health" do
+    send_resp(conn, 200, Jason.encode!(%{ok: true}))
+  end
+
+  get "/" do
+    html = """
+    <!doctype html>
+    <html lang="en">
+      <head>
+        <meta charset="utf-8" />
+        <title>__APP_NAME__</title>
+        <style>
+          body { font-family: system-ui, sans-serif; max-width: 640px; margin: 48px auto; padding: 0 24px; line-height: 1.6; }
+          h1 { letter-spacing: -0.5px; }
+        </style>
+      </head>
+      <body>
+        <h1>__APP_NAME__</h1>
+        <p>An Elixir app deployed on Percher.</p>
+        <p>To upgrade to full Phoenix, run <code>mix phx.new .</code> in this directory (replaces the current skeleton).</p>
+      </body>
+    </html>
+    """
+
+    conn
+    |> put_resp_content_type("text/html; charset=utf-8")
+    |> send_resp(200, html)
+  end
+
+  match _ do
+    send_resp(conn, 404, "Not found")
+  end
+end

package/dist/templates/phoenix/mix.exs

@@ -0,0 +1,30 @@
+defmodule PercherApp.MixProject do
+  use Mix.Project
+
+  def project do
+    [
+      app: :percher_app,
+      version: "0.1.0",
+      elixir: "~> 1.17",
+      start_permanent: Mix.env() == :prod,
+      deps: deps()
+    ]
+  end
+
+  def application do
+    [
+      extra_applications: [:logger],
+      mod: {PercherApp.Application, []}
+    ]
+  end
+
+  # Minimal Plug + Bandit. Run `mix phx.new .` once you're ready to upgrade
+  # to the full Phoenix framework — you'll replace this project skeleton.
+  defp deps do
+    [
+      {:plug, "~> 1.16"},
+      {:bandit, "~> 1.5"},
+      {:jason, "~> 1.4"}
+    ]
+  end
+end

package/dist/templates/phoenix/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "docker"
+framework = "phoenix"
+
+[web]
+port = 4000
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/preact/Caddyfile

@@ -0,0 +1,7 @@
+:8080 {
+	bind 0.0.0.0
+	root * /srv
+	encode gzip zstd
+	try_files {path} /index.html
+	file_server
+}

package/dist/templates/preact/Dockerfile

@@ -0,0 +1,34 @@
+# Multi-stage build: a Bun stage compiles the static bundle, then a
+# minimal Caddy image serves it. This project uses runtime = "docker"
+# (not "static") because Percher's static runtime serves pre-built
+# files only — it does not run a build command. Generated by Percher;
+# safe to edit and own.
+
+# --- Build stage: install deps and build the static bundle -----------
+FROM oven/bun:1-alpine AS build
+WORKDIR /app
+COPY . .
+RUN bun install && bun run build
+
+# --- Serve stage: minimal Caddy image --------------------------------
+# caddy:2-alpine ships /usr/bin/caddy with cap_net_bind_service file
+# caps. Percher runs every container with --security-opt
+# no-new-privileges, which makes execve refuse a cap-bearing binary
+# (an "operation not permitted" crash-loop). Copy Caddy onto a plain
+# alpine base and strip the caps with setcap -r — Caddy never needs
+# the cap here, it listens on :8080 (>= 1024).
+FROM caddy:2-alpine AS caddy-source
+FROM alpine:3.21
+COPY --from=caddy-source /usr/bin/caddy /usr/bin/caddy
+RUN apk add --no-cache libcap \
+ && setcap -r /usr/bin/caddy \
+ && apk del libcap \
+ && rm -rf /var/cache/apk/*
+COPY Caddyfile /etc/caddy/Caddyfile
+COPY --from=build /app/dist /srv
+# HOME points at the writable tmpfs so non-root Caddy can persist its
+# XDG state (storage-clean lock, config autosave) under Percher's
+# read-only root filesystem.
+ENV HOME=/tmp
+EXPOSE 8080
+CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile", "--adapter", "caddyfile"]

package/dist/templates/preact/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>__APP_NAME__</title>
+  </head>
+  <body>
+    <div id="app"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/dist/templates/preact/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "preact": "^10.22.0"
+  },
+  "devDependencies": {
+    "@preact/preset-vite": "^2.9.0",
+    "vite": "^5.3.0",
+    "typescript": "^5.5.0"
+  }
+}

package/dist/templates/preact/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "docker"
+framework = "preact"
+
+[web]
+port = 8080
+health = "/"
+
+[data]
+mode = "none"

package/dist/templates/preact/src/main.tsx

@@ -0,0 +1,13 @@
+import { render } from "preact";
+
+function App() {
+  return (
+    <main style={{ fontFamily: "system-ui", padding: 40 }}>
+      <h1>Hello from __APP_NAME__</h1>
+      <p>Preact + Vite, served as static from Percher.</p>
+    </main>
+  );
+}
+
+const root = document.getElementById("app");
+if (root) render(<App />, root);

package/dist/templates/preact/vite.config.ts

@@ -0,0 +1,6 @@
+import preact from "@preact/preset-vite";
+import { defineConfig } from "vite";
+
+export default defineConfig({
+  plugins: [preact()],
+});

package/dist/templates/python/main.py

@@ -0,0 +1,13 @@
+from fastapi import FastAPI
+
+app = FastAPI()
+
+
+@app.get("/health")
+async def health():
+    return {"status": "ok"}
+
+
+@app.get("/")
+async def root():
+    return {"message": "Hello from __APP_NAME__!"}

package/dist/templates/python/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "python"
+framework = "fastapi"
+
+[web]
+port = 8000
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/python/requirements.txt

@@ -0,0 +1,2 @@
+fastapi>=0.115.0
+uvicorn>=0.32.0

package/dist/templates/rails/Dockerfile

@@ -0,0 +1,11 @@
+FROM ruby:3.3-alpine
+WORKDIR /app
+RUN apk add --no-cache build-base \
+ && addgroup -S app && adduser -S app -G app
+COPY --chown=app:app Gemfile ./
+RUN bundle install --jobs 4 --retry 3
+COPY --chown=app:app . .
+RUN chown -R app:app /app /usr/local/bundle
+USER app
+EXPOSE 3000
+CMD ["bundle", "exec", "rackup", "-o", "0.0.0.0", "-p", "3000"]

package/dist/templates/rails/Gemfile

@@ -0,0 +1,12 @@
+source "https://rubygems.org"
+
+ruby "~> 3.3"
+
+# Minimal Rack app — run `rails new . --force` (with rails + sqlite3 gems added)
+# to upgrade to a full Rails project once you're ready.
+gem "rack", "~> 3.1"
+gem "rackup", "~> 2.1"
+# rackup 2.x no longer ships a default handler — pick one explicitly.
+# webrick is the lightest stdlib option for the starter; swap to puma
+# / falcon when scaling.
+gem "webrick", "~> 1.8"

package/dist/templates/rails/config.ru

@@ -0,0 +1,32 @@
+require "json"
+
+app = lambda do |env|
+  case env["PATH_INFO"]
+  when "/health"
+    [200, { "content-type" => "application/json" }, [JSON.generate({ ok: true })]]
+  when "/"
+    html = <<~HTML
+      <!doctype html>
+      <html lang="en">
+        <head>
+          <meta charset="utf-8" />
+          <title>__APP_NAME__</title>
+          <style>
+            body { font-family: system-ui, sans-serif; max-width: 640px; margin: 48px auto; padding: 0 24px; line-height: 1.6; }
+            h1 { letter-spacing: -0.5px; }
+          </style>
+        </head>
+        <body>
+          <h1>__APP_NAME__</h1>
+          <p>A Ruby app deployed on Percher.</p>
+          <p>To upgrade to full Rails, add <code>rails</code> to the Gemfile and run <code>bundle install &amp;&amp; rails new . --force --skip-bundle</code>.</p>
+        </body>
+      </html>
+    HTML
+    [200, { "content-type" => "text/html; charset=utf-8" }, [html]]
+  else
+    [404, { "content-type" => "text/plain" }, ["Not found"]]
+  end
+end
+
+run app

package/dist/templates/rails/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "docker"
+framework = "rails"
+
+[web]
+port = 3000
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/remix/app/root.tsx

@@ -0,0 +1,19 @@
+import { Links, Meta, Outlet, Scripts, ScrollRestoration } from "@remix-run/react";
+
+export default function App() {
+  return (
+    <html lang="en">
+      <head>
+        <meta charSet="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+        <Meta />
+        <Links />
+      </head>
+      <body>
+        <Outlet />
+        <ScrollRestoration />
+        <Scripts />
+      </body>
+    </html>
+  );
+}

package/dist/templates/remix/app/routes/_index.tsx

@@ -0,0 +1,10 @@
+export default function Index() {
+  return (
+    <main style={{ fontFamily: "system-ui", padding: 40 }}>
+      <h1>Hello from __APP_NAME__</h1>
+      <p>
+        Remix on Percher. Add routes under <code>app/routes/</code>.
+      </p>
+    </main>
+  );
+}

package/dist/templates/remix/app/routes/health.tsx

@@ -0,0 +1,3 @@
+export function loader() {
+  return Response.json({ status: "ok" });
+}

package/dist/templates/remix/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "remix vite:build",
+    "dev": "remix vite:dev",
+    "start": "remix-serve ./build/server/index.js"
+  },
+  "dependencies": {
+    "@remix-run/node": "^2.13.0",
+    "@remix-run/react": "^2.13.0",
+    "@remix-run/serve": "^2.13.0",
+    "isbot": "^5.1.0",
+    "react": "^18.3.0",
+    "react-dom": "^18.3.0"
+  },
+  "devDependencies": {
+    "@remix-run/dev": "^2.13.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "typescript": "^5.5.0",
+    "vite": "^5.3.0",
+    "vite-tsconfig-paths": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

package/dist/templates/remix/percher.toml

@@ -0,0 +1,15 @@
+[app]
+name = "__APP_NAME__"
+runtime = "node"
+framework = "remix"
+
+[build]
+command = "bun run build"
+output = "build"
+
+[web]
+port = 3000
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/remix/vite.config.ts

@@ -0,0 +1,7 @@
+import { vitePlugin as remix } from "@remix-run/dev";
+import { defineConfig } from "vite";
+import tsconfigPaths from "vite-tsconfig-paths";
+
+export default defineConfig({
+  plugins: [remix(), tsconfigPaths()],
+});