newcandies 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# newcandies
+
+A CLI to scaffold Expo Router + Uniwind React Native apps with layered templates.
+
+Highlights
+- Always Expo Router
+- ES6 arrow functions for root components
+- Pre-configured: react-native-reanimated, react-native-gesture-handler, react-native-safe-area-context, react-native-screens
+- Uniwind (Tailwind v4) configured out of the box
+- Choice of navigation style via Expo Router: Stack or Tabs
+- Template-driven extra dependencies per boilerplate
+
+Usage (after publish)
+- npx newcandies@latest
+
+Local dev
+- npm i
+- npm run build
+- npm link
+- newcandies

package/dist/index.js

@@ -0,0 +1,335 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import { Command } from "commander";
+import fs from "fs-extra";
+import path from "path";
+import { fileURLToPath } from "url";
+import { execa } from "execa";
+var TEMPLATE_MAP = {
+  "boilerplate/holidia": {
+    extraDeps: ["@tanstack/react-query", "@react-native-async-storage/async-storage"]
+  },
+  "boilerplate/supersimplenotes": {
+    extraDeps: ["@react-native-community/netinfo"]
+  }
+};
+var TEMPLATES = {
+  "boilerplate": [
+    { value: "holidia", label: "holidia" },
+    { value: "supersimplenotes", label: "supersimplenotes" }
+  ],
+  "mini-boilerplate": [
+    { value: "auth-mini", label: "Auth Mini" }
+  ],
+  "app-brief": {
+    categories: [
+      { value: "react-query", label: "react-query", variants: [{ value: "sproutsy", label: "sproutsy" }] }
+    ]
+  },
+  "mini-app-brief": { categories: [{ value: "forms", label: "forms", variants: [{ value: "lite", label: "lite" }] }] },
+  "default": [{ value: "default", label: "Default (Expo Router + Uniwind)" }]
+};
+var program = new Command().name("newcandies").option("-t, --type <type>").option("--template <name>").option("--category <name>").option("--variant <name>").option("-n, --navigator <navigator>", "stack|tabs", "tabs").option("-y, --yes").option("--pm <pm>", "npm|pnpm|yarn|bun").option("--no-install").parse(process.argv);
+var opts = program.opts();
+async function main() {
+  console.clear();
+  p.intro(pc.bgMagenta(pc.black(" newcandies ")));
+  const project = await p.group({
+    name: () => p.text({
+      message: "Project name?",
+      placeholder: "my-newcandies-app",
+      validate: (v) => !v ? "Enter a name" : /[^a-zA-Z0-9_-]/.test(v) ? "Use letters, numbers, _ or -" : void 0
+    }),
+    type: async () => {
+      if (opts.type) return opts.type;
+      return p.select({
+        message: "Pick type",
+        options: [
+          { value: "boilerplate", label: "Boilerplate (main projects)" },
+          { value: "mini-boilerplate", label: "Mini-boilerplate" },
+          { value: "app-brief", label: "App-brief (2 levels)" },
+          { value: "mini-app-brief", label: "Mini-app-brief (2 levels)" },
+          { value: "default", label: "Default" }
+        ]
+      });
+    },
+    template: async ({ results }) => {
+      if (results.type === "app-brief" || results.type === "mini-app-brief") return null;
+      if (opts.template) return opts.template;
+      const list = TEMPLATESafe(results.type);
+      return p.select({ message: "Pick template", options: list });
+    },
+    category: async ({ results }) => {
+      if (results.type !== "app-brief" && results.type !== "mini-app-brief") return null;
+      if (opts.category) return opts.category;
+      const cats = TEMPLATES[results.type].categories;
+      return p.select({ message: "Pick category", options: cats });
+    },
+    variant: async ({ results }) => {
+      if (results.type !== "app-brief" && results.type !== "mini-app-brief") return null;
+      if (opts.variant) return opts.variant;
+      const cats = TEMPLATES[results.type].categories;
+      const cat = cats.find((c) => c.value === results.category);
+      return p.select({ message: "Pick variant", options: cat.variants });
+    },
+    navigator: async () => {
+      if (opts.navigator) return opts.navigator;
+      return p.select({
+        message: "Navigator",
+        options: [
+          { value: "stack", label: "Stack" },
+          { value: "tabs", label: "Tabs" }
+        ],
+        initialValue: "tabs"
+      });
+    },
+    install: async () => {
+      if (opts.yes !== void 0) return !!opts.yes;
+      if (opts.install === false) return false;
+      return p.confirm({ message: "Install dependencies?", initialValue: true });
+    },
+    pm: async () => {
+      if (opts.pm) return opts.pm;
+      return p.select({
+        message: "Package manager?",
+        options: [
+          { value: "pnpm", label: "pnpm" },
+          { value: "npm", label: "npm" },
+          { value: "yarn", label: "yarn" },
+          { value: "bun", label: "bun" }
+        ],
+        initialValue: "pnpm"
+      });
+    }
+  }, { onCancel: () => {
+    p.cancel("Aborted");
+    process.exit(0);
+  } });
+  const dest = path.resolve(process.cwd(), project.name);
+  const s = p.spinner();
+  s.start("Scaffolding");
+  await fs.ensureDir(dest);
+  await writeBaseline({ dest, name: project.name, navigator: project.navigator });
+  await applyTemplateOverlay({ dest, type: project.type, template: project.template, category: project.category, variant: project.variant });
+  s.stop("Files ready");
+  const extraDeps = resolveExtraDeps({ type: project.type, template: project.template, category: project.category, variant: project.variant });
+  if (project.install) {
+    const si = p.spinner();
+    si.start("Installing dependencies (via Expo)");
+    await installDeps(project.pm, dest, extraDeps);
+    si.stop("Installed");
+  }
+  p.outro([
+    pc.green("Next steps:"),
+    `  cd ${project.name}`,
+    project.install ? "" : `  ${project.pm} install`,
+    `  ${project.pm} ${project.pm === "npm" ? "run " : ""}start`
+  ].filter(Boolean).join("\n"));
+}
+function TEMPLATESafe(type) {
+  const t = TEMPLATES[type];
+  if (Array.isArray(t)) return t;
+  return [{ value: "default", label: "Default (Expo Router + Uniwind)" }];
+}
+async function writeBaseline({ dest, name, navigator }) {
+  const pkg = {
+    name,
+    version: "0.0.0",
+    private: true,
+    main: "expo-router/entry",
+    scripts: {
+      start: "expo start",
+      android: "expo run:android",
+      ios: "expo run:ios"
+    }
+  };
+  await fs.writeJSON(path.join(dest, "package.json"), pkg, { spaces: 2 });
+  const appJson = {
+    expo: {
+      name,
+      slug: name,
+      scheme: "newcandies",
+      plugins: ["expo-router"],
+      experiments: { typedRoutes: true }
+    }
+  };
+  await fs.writeJSON(path.join(dest, "app.json"), appJson, { spaces: 2 });
+  const babel = `module.exports = function (api) {
+  api.cache(true);
+  return {
+    presets: ['babel-preset-expo'],
+    plugins: [
+      'expo-router/babel',
+      'react-native-reanimated/plugin'
+    ]
+  };
+};
+`;
+  await fs.writeFile(path.join(dest, "babel.config.js"), babel);
+  const metro = `const { getDefaultConfig } = require('expo/metro-config');
+const { withUniwindConfig } = require('uniwind/metro');
+
+const config = getDefaultConfig(__dirname);
+
+module.exports = withUniwindConfig(config, {
+  cssEntryFile: './app/global.css',
+  dtsFile: './app/uniwind-types.d.ts',
+});
+`;
+  await fs.writeFile(path.join(dest, "metro.config.js"), metro);
+  const tsconfig = {
+    compilerOptions: {
+      strict: true,
+      jsx: "react-native",
+      target: "ES2020",
+      moduleResolution: "node",
+      types: ["react", "react-native", "expo-router"]
+    },
+    include: ["app", "./app/uniwind-types.d.ts"]
+  };
+  await fs.writeJSON(path.join(dest, "tsconfig.json"), tsconfig, { spaces: 2 });
+  const appDir = path.join(dest, "app");
+  await fs.ensureDir(appDir);
+  const globalCss = `@import 'tailwindcss';
+@import 'uniwind';
+
+@layer theme {
+  :root {
+    @variant light {
+      --color-background: #ffffff;
+      --color-foreground: #111827;
+      --color-primary: #3b82f6;
+    }
+    @variant dark {
+      --color-background: #000000;
+      --color-foreground: #ffffff;
+      --color-primary: #60a5fa;
+    }
+  }
+}
+`;
+  await fs.writeFile(path.join(appDir, "global.css"), globalCss);
+  if (navigator === "tabs") {
+    const tabsDir = path.join(appDir, "(tabs)");
+    await fs.ensureDir(tabsDir);
+    const layout = `import 'react-native-gesture-handler';
+import '../global.css';
+import { Tabs } from 'expo-router';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+
+const TabsLayout = () => {
+  return (
+    <GestureHandlerRootView style={{ flex: 1 }}>
+      <SafeAreaProvider>
+        <Tabs screenOptions={{ headerShown: false }} />
+      </SafeAreaProvider>
+    </GestureHandlerRootView>
+  );
+};
+
+export default TabsLayout;
+`;
+    await fs.writeFile(path.join(tabsDir, "_layout.tsx"), layout);
+    const home = `import { View, Text } from 'react-native';
+
+const Home = () => (
+  <View className="flex-1 items-center justify-center bg-background">
+    <Text className="text-foreground text-xl">Home Tab</Text>
+  </View>
+);
+
+export default Home;
+`;
+    await fs.writeFile(path.join(tabsDir, "index.tsx"), home);
+    const settings = `import { View, Text } from 'react-native';
+
+const Settings = () => (
+  <View className="flex-1 items-center justify-center bg-background">
+    <Text className="text-foreground text-xl">Settings Tab</Text>
+  </View>
+);
+
+export default Settings;
+`;
+    await fs.writeFile(path.join(tabsDir, "settings.tsx"), settings);
+  } else {
+    const layout = `import 'react-native-gesture-handler';
+import './global.css';
+import { Stack } from 'expo-router';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+
+const RootLayout = () => {
+  return (
+    <GestureHandlerRootView style={{ flex: 1 }}>
+      <SafeAreaProvider>
+        <Stack screenOptions={{ headerShown: false }} />
+      </SafeAreaProvider>
+    </GestureHandlerRootView>
+  );
+};
+
+export default RootLayout;
+`;
+    await fs.writeFile(path.join(appDir, "_layout.tsx"), layout);
+    const index = `import { View, Text } from 'react-native';
+
+const Home = () => {
+  return (
+    <View className="flex-1 items-center justify-center bg-background">
+      <Text className="text-foreground text-xl">Hello from Stack + Uniwind + Router</Text>
+    </View>
+  );
+};
+
+export default Home;
+`;
+    await fs.writeFile(path.join(appDir, "index.tsx"), index);
+  }
+}
+async function applyTemplateOverlay({ dest, type, template, category, variant }) {
+  const __dirname = path.dirname(fileURLToPath(import.meta.url));
+  let src = null;
+  if (type === "app-brief" || type === "mini-app-brief") {
+    if (category && variant) {
+      src = path.join(__dirname, "..", "templates", type, category, variant);
+    }
+  } else if (type && template) {
+    src = path.join(__dirname, "..", "templates", type, template);
+  } else if (type === "default") {
+    src = path.join(__dirname, "..", "templates", "default");
+  }
+  if (src && await fs.pathExists(src)) {
+    await fs.copy(src, dest, { overwrite: true });
+  }
+}
+function resolveExtraDeps({ type, template, category, variant }) {
+  let key = null;
+  if (type === "boilerplate" && template) key = `${type}/${template}`;
+  if ((type === "app-brief" || type === "mini-app-brief") && category && variant) key = `${type}/${category}/${variant}`;
+  const spec = key ? TEMPLATE_MAP[key] : void 0;
+  return spec?.extraDeps ?? [];
+}
+async function installDeps(pm, cwd, extraDeps) {
+  const base = [
+    "expo",
+    "expo-router",
+    "react",
+    "react-native",
+    "react-native-reanimated",
+    "react-native-gesture-handler",
+    "react-native-safe-area-context",
+    "react-native-screens",
+    "tailwindcss",
+    "uniwind"
+  ];
+  await execa("npx", ["expo", "install", ...base, ...extraDeps], { cwd, stdio: "inherit" });
+}
+main().catch((e) => {
+  p.log.error(e?.message ?? String(e));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "newcandies",
+  "version": "0.1.0",
+  "description": "Scaffold Expo Router + Uniwind React Native apps with layered templates.",
+  "type": "module",
+  "bin": {
+    "newcandies": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": ["expo", "react-native", "expo-router", "tailwind", "uniwind", "cli", "scaffold"],
+  "license": "MIT",
+  "engines": { "node": ">=18" },
+  "scripts": {
+"build": "tsup src/index.ts --format esm --clean",
+"dev": "tsup src/index.ts --format esm --watch --clean=false",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "commander": "^12.1.0",
+    "execa": "^8.0.1",
+    "fs-extra": "^11.2.0",
+    "giget": "^1.2.1",
+    "picocolors": "^1.0.0",
+    "validate-npm-package-name": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.7.5",
+    "tsup": "^8.2.4",
+    "typescript": "^5.6.3"
+  }
+}

package/templates/boilerplate/holidia/README.md

@@ -0,0 +1,3 @@
+# Holidia template
+
+Adds a sample screen at `app/holi.tsx`. Extra deps will include React Query and AsyncStorage.

package/templates/boilerplate/holidia/app/holi.tsx

@@ -0,0 +1,9 @@
+import { View, Text } from 'react-native'
+
+const Holi = () => (
+  <View className="flex-1 items-center justify-center bg-background">
+    <Text className="text-foreground text-xl">Holidia overlay screen</Text>
+  </View>
+)
+
+export default Holi

package/templates/boilerplate/supersimplenotes/README.md

@@ -0,0 +1,3 @@
+# SuperSimpleNotes template
+
+Adds `app/notes.tsx`. Extra deps include `@react-native-community/netinfo`.

package/templates/boilerplate/supersimplenotes/app/notes.tsx

@@ -0,0 +1,9 @@
+import { View, Text } from 'react-native'
+
+const Notes = () => (
+  <View className="flex-1 items-center justify-center bg-background">
+    <Text className="text-foreground text-xl">SuperSimpleNotes overlay</Text>
+  </View>
+)
+
+export default Notes

package/templates/default/README.md

@@ -0,0 +1 @@
+Default overlay (empty).