npm - create-web-0to1 - Versions diffs - 0.1.0 - Mend

create-web-0to1 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (193) hide show

package/templates/monorepo/turbo/generators/templates/next-app/Dockerfile.tpl ADDED Viewed

@@ -0,0 +1,30 @@
+FROM node:lts-alpine AS base
+RUN npm install -g pnpm turbo
+WORKDIR /app
+FROM base AS pruner
+COPY . .
+RUN turbo prune __APPNAME__ --docker
+FROM base AS builder
+WORKDIR /app
+COPY --from=pruner /app/out/json/ .
+COPY --from=pruner /app/out/pnpm-lock.yaml ./pnpm-lock.yaml
+RUN pnpm install --frozen-lockfile
+COPY --from=pruner /app/out/full/ .
+RUN pnpm turbo build --filter=__APPNAME__
+FROM node:lts-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV HOSTNAME=0.0.0.0
+COPY --from=builder /app/apps/__APPNAME__/public ./apps/__APPNAME__/public
+COPY --from=builder /app/apps/__APPNAME__/.next/standalone ./
+COPY --from=builder /app/apps/__APPNAME__/.next/static ./apps/__APPNAME__/.next/static
+EXPOSE 3000
+CMD ["node", "apps/__APPNAME__/server.js"]

package/templates/monorepo/turbo/generators/templates/next-app/README.md.tpl ADDED Viewed

@@ -0,0 +1,118 @@
+# [[APPNAME]]
+`[[APP_PATH]]`는 monorepo generator로 만든 Next.js 앱입니다. `create-next-app` 기본 scaffold 위에 공용 설정과 core wiring이 이미 연결되어 있습니다.
+## 빠른 시작
+레포 루트에서 실행하세요.
+```bash
+pnpm install
+pnpm --filter "./apps/[[APPNAME]]" dev
+```
+자주 쓰는 명령:
+```bash
+pnpm --filter "./apps/[[APPNAME]]" lint
+pnpm --filter "./apps/[[APPNAME]]" check-types
+pnpm --filter "./apps/[[APPNAME]]" build
+```
+## 환경 변수
+generator가 `[[ENV_FILE_PATH]]`를 같이 만들었습니다.
+```env
+[[ENV_SNIPPET]]
+```
+- `[[SITE_ID_ENV_KEY]]`: 현재 값은 `[[SITE_ID]]`
+- `[[BASE_URL_ENV_KEY]]`: 현재 값은 `[[BASE_URL]]`
+## 기본 연결
+- `[[LAYOUT_PATH]]`: `CoreBootstrap`와 `Providers`를 연결합니다.
+- `[[PROVIDERS_PATH]]`: `AppProviders`와 전역 query 에러 핸들러를 연결합니다.
+- `[[PAGE_PATH]]`: 첫 페이지 예시입니다.
+- `[[GLOBAL_ERROR_PATH]]`: 전역 에러 UI입니다.
+지금 layout은 이미 `process.env.[[SITE_ID_ENV_KEY]]`와 `process.env.[[BASE_URL_ENV_KEY]]`를 읽도록 연결되어 있습니다. 보통은 `.env.local` 값만 바꾸시면 됩니다.
+## API 사용 규칙
+API 함수는 항상 `@repo/core/api/*`에서 직접 import합니다.
+```tsx
+import { testFetch } from "@repo/core/api/test";
+export default async function Page() {
+  const data = await testFetch();
+  return <pre>{JSON.stringify(data, null, 2)}</pre>;
+}
+```
+다음 패턴은 피해주세요.
+- `@repo/core` 루트에 API를 다시 모으기
+- `@repo/core-next`에서 API를 가져오기
+## 새 API 추가하기
+새 API는 `packages/core/src/api/*.ts`에 파일 단위로 추가합니다.
+```ts
+import { z } from "zod";
+import { coreFetch, type CoreFetchOptions } from "../api";
+import { parseWithSchema } from "../schema-utils";
+const articleSchema = z.object({
+  id: z.number(),
+  title: z.string(),
+});
+const articleListSchema = z.array(articleSchema);
+export async function listArticles(options?: CoreFetchOptions) {
+  const payload = await coreFetch<unknown>("/articles", {
+    ...options,
+    baseUrl: "https://api.example.com",
+  });
+  return parseWithSchema(articleListSchema, payload);
+}
+```
+앱에서는 바로 이렇게 가져다 쓰시면 됩니다.
+```ts
+import { listArticles } from "@repo/core/api/article";
+```
+## 인증 포함 호출
+서버 컴포넌트나 route handler에서는 `withServerAuth()`를 붙이면 됩니다.
+```tsx
+import { testFetch } from "@repo/core/api/test";
+import { withServerAuth } from "@repo/core-next/server-auth";
+const authTestFetch = withServerAuth(testFetch);
+const data = await authTestFetch();
+```
+클라이언트 호출에서 쿠키를 같이 보내려면 `withClientAuth()`를 사용하세요.
+```tsx
+import { testFetch } from "@repo/core/api/test";
+import { withClientAuth } from "@repo/core-next/client-auth";
+const authTestFetch = withClientAuth(testFetch);
+const data = await authTestFetch();
+```
+## 더 보기
+공통 규칙과 패키지 구조는 [루트 README]([[ROOT_README_PATH]])를 참고해주세요.

package/templates/monorepo/turbo/generators/templates/next-app/app/global-error.tsx.tpl ADDED Viewed

@@ -0,0 +1,12 @@
+"use client";
+export default function GlobalError({ error }: { error: Error }) {
+  return (
+    <html>
+      <body>
+        <h2>Error</h2>
+        <pre>{error.message}</pre>
+      </body>
+    </html>
+  );
+}

package/templates/monorepo/turbo/generators/templates/next-app/app/globals.css.tpl ADDED Viewed

	@@ -0,0 +1 @@
1	+

package/templates/monorepo/turbo/generators/templates/next-app/app/layout.tsx.tpl ADDED Viewed

@@ -0,0 +1,29 @@
+import "./globals.css";
+import { CoreBootstrap } from "@repo/core-next/bootstrap";
+import type { Metadata } from "next";
+import { Providers } from "./providers";
+export const metadata: Metadata = {
+  title: "__APPNAME__",
+  description: "__APPNAME__ application",
+};
+const SITE_ID = process.env.NEXT_PUBLIC_SITE_ID ?? "a";
+const BASE_URL = process.env.NEXT_PUBLIC_API_BASE_URL || undefined;
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="ko">
+      <body>
+        <CoreBootstrap siteId={SITE_ID} baseUrl={BASE_URL} />
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

package/templates/monorepo/turbo/generators/templates/next-app/app/page.tsx.tpl ADDED Viewed

@@ -0,0 +1,7 @@
+import { testFetch } from "@repo/core/api/test";
+export default async function Home() {
+  const data = await testFetch();
+  return <div>{JSON.stringify(data)}</div>;
+}

package/templates/monorepo/turbo/generators/templates/next-app/app/providers.tsx.tpl ADDED Viewed

@@ -0,0 +1,25 @@
+"use client";
+import {
+  AppProviders,
+  createClientQueryErrorHandler,
+} from "@repo/core-next";
+import type { ReactNode } from "react";
+const handleClientQueryError = createClientQueryErrorHandler({
+  onUnauthorized: () => {
+    window.location.href = "/login";
+  },
+});
+type ProvidersProps = {
+  children: ReactNode;
+};
+export function Providers({ children }: ProvidersProps) {
+  return (
+    <AppProviders onGlobalError={handleClientQueryError}>
+      {children}
+    </AppProviders>
+  );
+}

package/templates/monorepo/turbo/generators/templates/next-app/eslint.config.js.tpl ADDED Viewed

@@ -0,0 +1,4 @@
+import { nextJsConfig } from "@repo/eslint-config/next-js";
+/** @type {import("eslint").Linter.Config[]} */
+export default nextJsConfig;

package/templates/monorepo/turbo/generators/templates/next-app/next.config.js.tpl ADDED Viewed

@@ -0,0 +1,6 @@
+/** @type {import("next").NextConfig} */
+const nextConfig = {
+  output: "standalone",
+};
+export default nextConfig;

package/templates/monorepo/turbo/generators/templates/next-app/tsconfig.json.tpl ADDED Viewed

@@ -0,0 +1,18 @@
+{
+  "extends": "@repo/typescript-config/nextjs.json",
+  "compilerOptions": {
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "next-env.d.ts",
+    "next.config.js",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/monorepo/turbo/generators/templates/vite-app/Dockerfile.tpl ADDED Viewed

@@ -0,0 +1,22 @@
+FROM node:lts-alpine AS base
+RUN npm install -g pnpm turbo
+WORKDIR /app
+FROM base AS pruner
+COPY . .
+RUN turbo prune __APPNAME__ --out-dir=out --docker
+FROM base AS builder
+WORKDIR /app
+COPY --from=pruner /app/out/json/ .
+COPY --from=pruner /app/out/pnpm-lock.yaml ./pnpm-lock.yaml
+RUN pnpm install --frozen-lockfile
+COPY --from=pruner /app/out/full/ .
+RUN pnpm turbo build --filter=__APPNAME__
+FROM nginx:stable-alpine AS runner
+COPY --from=builder /app/apps/__APPNAME__/dist /usr/share/nginx/html
+EXPOSE 80
+CMD ["nginx", "-g", "daemon off;"]

package/templates/monorepo/turbo/generators/templates/vite-app/README.plain.md.tpl ADDED Viewed

@@ -0,0 +1,90 @@
+# [[APPNAME]]
+`[[APP_PATH]]`는 monorepo generator로 만든 Vite 앱입니다. 공용 설정과 `initCore()` 기본 wiring이 이미 연결되어 있습니다.
+## 빠른 시작
+레포 루트에서 실행하세요.
+```bash
+pnpm install
+pnpm --filter "./apps/[[APPNAME]]" dev
+```
+자주 쓰는 명령:
+```bash
+pnpm --filter "./apps/[[APPNAME]]" lint
+pnpm --filter "./apps/[[APPNAME]]" check-types
+pnpm --filter "./apps/[[APPNAME]]" build
+```
+## 환경 변수
+generator가 `[[ENV_FILE_PATH]]`를 같이 만들었습니다.
+```env
+[[ENV_SNIPPET]]
+```
+- `[[SITE_ID_ENV_KEY]]`: 현재 값은 `[[SITE_ID]]`
+- `[[BASE_URL_ENV_KEY]]`: 현재 값은 `[[BASE_URL]]`
+## 기본 연결
+- `[[ENTRY_PATH]]`: env 값을 읽어 앱 시작 시 `initCore()`를 호출합니다.
+지금 엔트리 파일은 이미 `import.meta.env.[[SITE_ID_ENV_KEY]]`와 `import.meta.env.[[BASE_URL_ENV_KEY]]`를 읽어서 `initCore()`를 호출하도록 연결되어 있습니다.
+## API 사용 규칙
+API 함수는 항상 `@repo/core/api/*`에서 직접 import합니다.
+```ts
+import { testFetch } from "@repo/core/api/test";
+async function bootstrap() {
+  const data = await testFetch();
+  document.body.innerHTML = `<pre>${JSON.stringify(data, null, 2)}</pre>`;
+}
+void bootstrap();
+```
+## 새 API 추가하기
+새 API는 `packages/core/src/api/*.ts`에 파일 단위로 추가합니다.
+```ts
+import { z } from "zod";
+import { coreFetch, type CoreFetchOptions } from "../api";
+import { parseWithSchema } from "../schema-utils";
+const articleSchema = z.object({
+  id: z.number(),
+  title: z.string(),
+});
+const articleListSchema = z.array(articleSchema);
+export async function listArticles(options?: CoreFetchOptions) {
+  const payload = await coreFetch<unknown>("/articles", {
+    ...options,
+    baseUrl: "https://api.example.com",
+  });
+  return parseWithSchema(articleListSchema, payload);
+}
+```
+앱에서는 바로 이렇게 가져다 쓰시면 됩니다.
+```ts
+import { listArticles } from "@repo/core/api/article";
+```
+## 더 보기
+공통 규칙과 패키지 구조는 [루트 README]([[ROOT_README_PATH]])를 참고해주세요.

package/templates/monorepo/turbo/generators/templates/vite-app/README.react.md.tpl ADDED Viewed

@@ -0,0 +1,107 @@
+# [[APPNAME]]
+`[[APP_PATH]]`는 monorepo generator로 만든 React + Vite 앱입니다. 공용 설정과 provider wiring이 이미 연결되어 있습니다.
+## 빠른 시작
+레포 루트에서 실행하세요.
+```bash
+pnpm install
+pnpm --filter "./apps/[[APPNAME]]" dev
+```
+자주 쓰는 명령:
+```bash
+pnpm --filter "./apps/[[APPNAME]]" lint
+pnpm --filter "./apps/[[APPNAME]]" check-types
+pnpm --filter "./apps/[[APPNAME]]" build
+```
+## 환경 변수
+generator가 `[[ENV_FILE_PATH]]`를 같이 만들었습니다.
+```env
+[[ENV_SNIPPET]]
+```
+- `[[SITE_ID_ENV_KEY]]`: 현재 값은 `[[SITE_ID]]`
+- `[[BASE_URL_ENV_KEY]]`: 현재 값은 `[[BASE_URL]]`
+## 기본 연결
+- `[[ENTRY_PATH]]`: env 값을 읽어 `initCore()`와 `<Providers><App /></Providers>`를 연결합니다.
+- `[[PROVIDERS_PATH]]`: `AppProviders`와 전역 query 에러 핸들러를 연결합니다.
+지금 엔트리 파일은 이미 `import.meta.env.[[SITE_ID_ENV_KEY]]`와 `import.meta.env.[[BASE_URL_ENV_KEY]]`를 읽어서 `initCore()`를 호출하도록 연결되어 있습니다.
+## API 사용 규칙
+API 함수는 항상 `@repo/core/api/*`에서 직접 import합니다.
+```tsx
+import { useEffect, useState } from "react";
+import { testFetch } from "@repo/core/api/test";
+export function Example() {
+  const [items, setItems] = useState<unknown[]>([]);
+  useEffect(() => {
+    testFetch().then(setItems);
+  }, []);
+  return <pre>{JSON.stringify(items, null, 2)}</pre>;
+}
+```
+## 새 API 추가하기
+새 API는 `packages/core/src/api/*.ts`에 파일 단위로 추가합니다.
+```ts
+import { z } from "zod";
+import { coreFetch, type CoreFetchOptions } from "../api";
+import { parseWithSchema } from "../schema-utils";
+const articleSchema = z.object({
+  id: z.number(),
+  title: z.string(),
+});
+const articleListSchema = z.array(articleSchema);
+export async function listArticles(options?: CoreFetchOptions) {
+  const payload = await coreFetch<unknown>("/articles", {
+    ...options,
+    baseUrl: "https://api.example.com",
+  });
+  return parseWithSchema(articleListSchema, payload);
+}
+```
+앱에서는 바로 이렇게 가져다 쓰시면 됩니다.
+```ts
+import { listArticles } from "@repo/core/api/article";
+```
+## 인증 포함 호출
+브라우저에서 쿠키를 같이 보내려면 `withClientAuth()`를 사용하세요.
+```ts
+import { testFetch } from "@repo/core/api/test";
+import { withClientAuth } from "@repo/core-react";
+const authTestFetch = withClientAuth(testFetch);
+const data = await authTestFetch();
+```
+## 더 보기
+공통 규칙과 패키지 구조는 [루트 README]([[ROOT_README_PATH]])를 참고해주세요.

package/templates/monorepo/turbo/generators/templates/vite-app/eslint.config.mjs.tpl ADDED Viewed

@@ -0,0 +1,4 @@
+import { config } from "@repo/eslint-config/base";
+/** @type {import("eslint").Linter.Config} */
+export default config;

package/templates/monorepo/turbo/generators/templates/vite-app/index.html.tpl ADDED Viewed

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

package/templates/monorepo/turbo/generators/templates/vite-app/index.ts.tpl ADDED Viewed

@@ -0,0 +1,22 @@
+import { initCore, normalizeAppError } from "@repo/core";
+import { testFetch } from "@repo/core/api/test";
+initCore("a");
+const app = document.querySelector("#app");
+(async () => {
+  try {
+    const data = await testFetch();
+    if (app) {
+      app.textContent = JSON.stringify(data);
+    }
+  } catch (error) {
+    const appError = normalizeAppError(error);
+    if (app) {
+      app.textContent = appError.message;
+    }
+  }
+})();

package/templates/monorepo/turbo/generators/templates/vite-app/tsconfig.json.tpl ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "extends": "@repo/typescript-config/base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "moduleResolution": "nodenext"
+  },
+  "include": ["src", "./index.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/monorepo/turbo/generators/templates/vite-app/vite.config.ts.tpl ADDED Viewed

@@ -0,0 +1,6 @@
+import { defineConfig } from "vite";
+import tsConfigPaths from "vite-tsconfig-paths";
+export default defineConfig({
+  plugins: [tsConfigPaths()],
+});

package/templates/monorepo/turbo.json ADDED Viewed

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://turborepo.dev/schema.json",
+  "globalEnv": [
+    "NODE_ENV",
+    "NEXT_PUBLIC_SITE_ID",
+    "NEXT_PUBLIC_API_BASE_URL",
+    "VITE_SITE_ID",
+    "VITE_API_BASE_URL"
+  ],
+  "ui": "tui",
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "inputs": ["$TURBO_DEFAULT$", ".env*"],
+      "outputs": [".next/**", "!.next/cache/**", "dist/**"]
+    },
+    "lint": {
+      "dependsOn": ["^lint"]
+    },
+    "check-types": {
+      "dependsOn": ["^check-types"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    }
+  }
+}

package/templates/next/.env.example ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ API_BASE_URL=http://localhost:4000
2	+ NEXT_PUBLIC_API_BASE_URL=http://localhost:4000

package/templates/next/.prettierignore ADDED Viewed

@@ -0,0 +1,9 @@
+.next
+out
+build
+coverage
+node_modules
+package-lock.json
+bun.lock
+pnpm-lock.yaml
+yarn.lock

package/templates/next/.prettierrc.json ADDED Viewed

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always"
+}