Module

x/fresh/init.ts

The next-gen web framework.
Extremely Popular
Go to Latest
File
import { gte, join, parse, resolve } from "./src/dev/deps.ts";import { error } from "./src/dev/error.ts";import { collect, generate } from "./src/dev/mod.ts";
const MIN_VERSION = "1.23.0";
// Check that the minimum supported Deno version is being used.if (!gte(Deno.version.deno, MIN_VERSION)) { let message = `Deno version ${MIN_VERSION} or higher is required. Please update Deno.\n\n`;
if (Deno.execPath().includes("homebrew")) { message += "You seem to have installed Deno via homebrew. To update, run: `brew upgrade deno`\n"; } else { message += "To update, run: `deno upgrade`\n"; }
error(message);}
const help = `fresh-init
Initialize a new Fresh project. This will create all the necessary files for anew project.
To generate a project in the './foobar' subdirectory: fresh-init ./foobar
To generate a project in the current directory: fresh-init .
USAGE: fresh-init <DIRECTORY>
OPTIONS: --force Overwrite existing files --twind Setup project to use 'twind' for styling --vscode Setup project for VSCode`;
const CONFIRM_EMPTY_MESSAGE = "The target directory is not empty (files could get overwritten). Do you want to continue anyway?";
const USE_TWIND_MESSAGE = "Do you want to use 'twind' (https://twind.dev/) for styling?";
const USE_VSCODE_MESSAGE = "Do you use VS Code?";
const flags = parse(Deno.args, { boolean: ["force", "twind", "vscode"], default: { "force": null, "twind": null, "vscode": null },});
if (flags._.length !== 1) { error(help);}
let directory = Deno.args[0];directory = resolve(directory);
try { const dir = [...Deno.readDirSync(directory)]; const isEmpty = dir.length === 0 || dir.length === 1 && dir[0].name === ".git"; if ( !isEmpty && !(flags.force === null ? confirm(CONFIRM_EMPTY_MESSAGE) : flags.force) ) { error("Directory is not empty."); }} catch (err) { if (!(err instanceof Deno.errors.NotFound)) { throw err; }}
const useTwind = flags.twind === null ? confirm(USE_TWIND_MESSAGE) : flags.twind;
const useVSCode = flags.vscode === null ? confirm(USE_VSCODE_MESSAGE) : flags.vscode;
await Deno.mkdir(join(directory, "routes", "api"), { recursive: true });await Deno.mkdir(join(directory, "islands"), { recursive: true });await Deno.mkdir(join(directory, "static"), { recursive: true });if (useVSCode) { await Deno.mkdir(join(directory, ".vscode"), { recursive: true });}if (useTwind) await Deno.mkdir(join(directory, "utils"), { recursive: true });
const importMap = { "imports": { "$fresh/": new URL("./", import.meta.url).href, "preact": "https://esm.sh/preact@10.8.2", "preact/": "https://esm.sh/preact@10.8.2/", "preact-render-to-string": "https://esm.sh/preact-render-to-string@5.2.0?deps=preact@10.8.2", } as Record<string, string>,};if (useTwind) { importMap.imports["@twind"] = "./utils/twind.ts"; importMap.imports["twind"] = "https://esm.sh/twind@0.16.17"; importMap.imports["twind/"] = "https://esm.sh/twind@0.16.17/";}const IMPORT_MAP_JSON = JSON.stringify(importMap, null, 2) + "\n";await Deno.writeTextFile(join(directory, "import_map.json"), IMPORT_MAP_JSON);
let ROUTES_INDEX_TSX = `/** @jsx h */import { h } from "preact";\n`;if (useTwind) ROUTES_INDEX_TSX += `import { tw } from "@twind";\n`;ROUTES_INDEX_TSX += `import Counter from "../islands/Counter.tsx";
export default function Home() { return ( <div${useTwind ? " class={tw\`p-4 mx-auto max-w-screen-md\`}" : ""}> <img src="/logo.svg" height="100px" alt="the fresh logo: a sliced lemon dripping with juice" /> <p${useTwind ? " class={tw\`my-6\`}" : ""}> Welcome to \`fresh\`. Try update this message in the ./routes/index.tsx file, and refresh. </p> <Counter start={3} /> </div> );}`;await Deno.writeTextFile( join(directory, "routes", "index.tsx"), ROUTES_INDEX_TSX,);
let ISLANDS_COUNTER_TSX = `/** @jsx h */import { h } from "preact";import { useState } from "preact/hooks";import { IS_BROWSER } from "$fresh/runtime.ts";${useTwind ? 'import { tw } from "@twind";\n' : ""}interface CounterProps { start: number;}
export default function Counter(props: CounterProps) { const [count, setCount] = useState(props.start);`;
if (useTwind) { ISLANDS_COUNTER_TSX += ` const btn = tw\`px-2 py-1 border(gray-100 1) hover:bg-gray-200\`;\n`; ISLANDS_COUNTER_TSX += ` return ( <div class={tw\`flex gap-2 w-full\`}> <p class={tw\`flex-grow-1 font-bold text-xl\`}>{count}</p> <button class={btn} onClick={() => setCount(count - 1)} disabled={!IS_BROWSER} > -1 </button> <button class={btn} onClick={() => setCount(count + 1)} disabled={!IS_BROWSER} > +1 </button> </div> );`;} else { ISLANDS_COUNTER_TSX += ` return ( <div> <p>{count}</p> <button onClick={() => setCount(count - 1)} disabled={!IS_BROWSER}> -1 </button> <button onClick={() => setCount(count + 1)} disabled={!IS_BROWSER}> +1 </button> </div> );`;}ISLANDS_COUNTER_TSX += `}\n`;await Deno.writeTextFile( join(directory, "islands", "Counter.tsx"), ISLANDS_COUNTER_TSX,);
const ROUTES_GREET_TSX = `/** @jsx h */import { h } from "preact";import { PageProps } from "$fresh/server.ts";
export default function Greet(props: PageProps) { return <div>Hello {props.params.name}</div>;}`;await Deno.writeTextFile( join(directory, "routes", "[name].tsx"), ROUTES_GREET_TSX,);
const ROUTES_API_JOKE_TS = `import { HandlerContext } from "$fresh/server.ts";
// Jokes courtesy of https://punsandoneliners.com/randomness/programmer-jokes/const JOKES = [ "Why do Java developers often wear glasses? They can't C#.", "A SQL query walks into a bar, goes up to two tables and says “can I join you?”", "Wasn't hard to crack Forrest Gump's password. 1forrest1.", "I love pressing the F5 key. It's refreshing.", "Called IT support and a chap from Australia came to fix my network connection. I asked “Do you come from a LAN down under?”", "There are 10 types of people in the world. Those who understand binary and those who don't.", "Why are assembly programmers often wet? They work below C level.", "My favourite computer based band is the Black IPs.", "What programme do you use to predict the music tastes of former US presidential candidates? An Al Gore Rhythm.", "An SEO expert walked into a bar, pub, inn, tavern, hostelry, public house.",];
export const handler = (_req: Request, _ctx: HandlerContext): Response => { const randomIndex = Math.floor(Math.random() * JOKES.length); const body = JOKES[randomIndex]; return new Response(body);};`;await Deno.writeTextFile( join(directory, "routes", "api", "joke.ts"), ROUTES_API_JOKE_TS,);
const UTILS_TWIND_TS = `import { IS_BROWSER } from "$fresh/runtime.ts";import { Configuration, setup } from "twind";export * from "twind";export const config: Configuration = { darkMode: "class", mode: "silent",};if (IS_BROWSER) setup(config);`;if (useTwind) { await Deno.writeTextFile( join(directory, "utils", "twind.ts"), UTILS_TWIND_TS, );}
const STATIC_LOGO = `<svg width="40" height="40" fill="none" xmlns="http://www.w3.org/2000/svg"> <path d="M34.092 8.845C38.929 20.652 34.092 27 30 30.5c1 3.5-2.986 4.222-4.5 2.5-4.457 1.537-13.512 1.487-20-5C2 24.5 4.73 16.714 14 11.5c8-4.5 16-7 20.092-2.655Z" fill="#FFDB1E"/> <path d="M14 11.5c6.848-4.497 15.025-6.38 18.368-3.47C37.5 12.5 21.5 22.612 15.5 25c-6.5 2.587-3 8.5-6.5 8.5-3 0-2.5-4-5.183-7.75C2.232 23.535 6.16 16.648 14 11.5Z" fill="#fff" stroke="#FFDB1E"/> <path d="M28.535 8.772c4.645 1.25-.365 5.695-4.303 8.536-3.732 2.692-6.606 4.21-7.923 4.83-.366.173-1.617-2.252-1.617-1 0 .417-.7 2.238-.934 2.326-1.365.512-4.223 1.29-5.835 1.29-3.491 0-1.923-4.754 3.014-9.122.892-.789 1.478-.645 2.283-.645-.537-.773-.534-.917.403-1.546C17.79 10.64 23 8.77 25.212 8.42c.366.014.82.35.82.629.41-.14 2.095-.388 2.503-.278Z" fill="#FFE600"/> <path d="M14.297 16.49c.985-.747 1.644-1.01 2.099-2.526.566.121.841-.08 1.29-.701.324.466 1.657.608 2.453.701-.715.451-1.057.852-1.452 2.106-1.464-.611-3.167-.302-4.39.42Z" fill="#fff"/></svg>`;
await Deno.writeTextFile( join(directory, "static", "logo.svg"), STATIC_LOGO,);
try { const faviconArrayBuffer = await fetch("https://fresh.deno.dev/favicon.ico") .then((d) => d.arrayBuffer()); await Deno.writeFile( join(directory, "static", "favicon.ico"), new Uint8Array(faviconArrayBuffer), );} catch { // Skip this and be silent if there is a nework issue.}
let MAIN_TS = `/// <reference no-default-lib="true" />/// <reference lib="dom" />/// <reference lib="dom.asynciterable" />/// <reference lib="deno.ns" />/// <reference lib="deno.unstable" />
import { ${ useTwind ? "InnerRenderFunction, RenderContext, " : ""}start } from "$fresh/server.ts";import manifest from "./fresh.gen.ts";`;
if (useTwind) { MAIN_TS += `import { config, setup } from "@twind";import { virtualSheet } from "twind/sheets";
const sheet = virtualSheet();sheet.reset();setup({ ...config, sheet });
function render(ctx: RenderContext, render: InnerRenderFunction) { const snapshot = ctx.state.get("twind") as unknown[] | null; sheet.reset(snapshot || undefined); render(); ctx.styles.splice(0, ctx.styles.length, ...(sheet).target); const newSnapshot = sheet.reset(); ctx.state.set("twind", newSnapshot);}
`;}
MAIN_TS += `await start(manifest${useTwind ? ", { render }" : ""});\n`;const MAIN_TS_PATH = join(directory, "main.ts");await Deno.writeTextFile(MAIN_TS_PATH, MAIN_TS);
const DEV_TS = `#!/usr/bin/env -S deno run -A --watch=static/,routes/
import dev from "$fresh/dev.ts";
await dev(import.meta.url, "./main.ts");`;const DEV_TS_PATH = join(directory, "dev.ts");await Deno.writeTextFile(DEV_TS_PATH, DEV_TS);try { await Deno.chmod(DEV_TS_PATH, 0o777);} catch { // this throws on windows}
const config = { tasks: { start: "deno run -A --watch=static/,routes/ dev.ts", }, importMap: "./import_map.json",};const DENO_CONFIG = JSON.stringify(config, null, 2) + "\n";
await Deno.writeTextFile(join(directory, "deno.json"), DENO_CONFIG);
const README_MD = `# fresh project
### Usage
Start the project:
\`\`\`deno task start\`\`\`
This will watch the project directory and restart as necessary.`;await Deno.writeTextFile( join(directory, "README.md"), README_MD,);
const vscodeSettings = { "deno.enable": true,};
const VSCODE_SETTINGS = JSON.stringify(vscodeSettings, null, 2) + "\n";
if (useVSCode) { await Deno.writeTextFile( join(directory, ".vscode", "settings.json"), VSCODE_SETTINGS, );}
const vscodeExtensions = { recommendations: ["denoland.vscode-deno"],};
const VSCODE_EXTENSIONS = JSON.stringify(vscodeExtensions, null, 2) + "\n";
if (useVSCode) { await Deno.writeTextFile( join(directory, ".vscode", "extensions.json"), VSCODE_EXTENSIONS, );}
const manifest = await collect(directory);await generate(directory, manifest);
console.log("\n%cProject created!", "color: green; font-weight: bold");console.log("\`cd my-project\` to enter to the project directory.");console.log("Run \`deno task start\` to start the development server.");