@clubedge/create-clubedge-app 0.3.0 → 0.4.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 (81) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/README.md +29 -13
  3. package/dist/cli/args.js +5 -0
  4. package/dist/cli/ui.js +2 -0
  5. package/dist/core/customize.js +40 -1
  6. package/dist/core/manifest.js +41 -3
  7. package/dist/core/plan.js +68 -3
  8. package/dist/index.js +42 -7
  9. package/dist/utils/fs.js +3 -0
  10. package/package.json +5 -4
  11. package/template/.dockerignore +3 -0
  12. package/template/.github/workflows/ci.yml +51 -4
  13. package/template/.prettierignore +1 -0
  14. package/template/AGENTS.md +3 -2
  15. package/template/CONTRIBUTING.md +2 -2
  16. package/template/README.md +18 -5
  17. package/template/SETUP.md +23 -1
  18. package/template/_gitignore +4 -0
  19. package/template/apps/start/.env.example +27 -0
  20. package/template/apps/start/AGENTS.md +11 -0
  21. package/template/apps/start/Dockerfile +38 -0
  22. package/template/apps/start/package.json +37 -0
  23. package/template/apps/start/public/.well-known/logo.svg +1 -0
  24. package/template/apps/start/public/favicon.ico +0 -0
  25. package/template/apps/start/src/components/auth/auth-form-controls.tsx +108 -0
  26. package/template/apps/start/src/components/branding/clubedge-mark.tsx +24 -0
  27. package/template/apps/start/src/components/dashboard/account-button.tsx +33 -0
  28. package/template/apps/start/src/components/dashboard/app-sidebar.tsx +90 -0
  29. package/template/apps/start/src/components/landing/copy-command.tsx +46 -0
  30. package/template/apps/start/src/components/theme/theme-provider.tsx +41 -0
  31. package/template/apps/start/src/components/theme/theme-toggle.tsx +21 -0
  32. package/template/apps/start/src/config/site.json +11 -0
  33. package/template/apps/start/src/config/site.ts +20 -0
  34. package/template/apps/start/src/env/server.test.ts +48 -0
  35. package/template/apps/start/src/env/server.ts +67 -0
  36. package/template/apps/start/src/lib/login-url.test.ts +16 -0
  37. package/template/apps/start/src/lib/login-url.ts +16 -0
  38. package/template/apps/start/src/routeTree.gen.ts +220 -0
  39. package/template/apps/start/src/router.tsx +27 -0
  40. package/template/apps/start/src/routes/__root.tsx +59 -0
  41. package/template/apps/start/src/routes/api/health.ts +15 -0
  42. package/template/apps/start/src/routes/auth/callback.ts +10 -0
  43. package/template/apps/start/src/routes/auth/sign-in.ts +11 -0
  44. package/template/apps/start/src/routes/auth/sign-out.ts +11 -0
  45. package/template/apps/start/src/routes/auth/sign-up.ts +11 -0
  46. package/template/apps/start/src/routes/dashboard.tsx +351 -0
  47. package/template/apps/start/src/routes/index.tsx +233 -0
  48. package/template/apps/start/src/routes/login.tsx +164 -0
  49. package/template/apps/start/src/server/auth-forms.test.ts +169 -0
  50. package/template/apps/start/src/server/auth-forms.ts +118 -0
  51. package/template/apps/start/src/server/auth.functions.ts +27 -0
  52. package/template/apps/start/src/server/auth.ts +51 -0
  53. package/template/apps/start/src/server/cache.ts +38 -0
  54. package/template/apps/start/src/server/cookies.test.ts +41 -0
  55. package/template/apps/start/src/server/cookies.ts +31 -0
  56. package/template/apps/start/src/server/db.ts +16 -0
  57. package/template/apps/start/src/server/storage.ts +39 -0
  58. package/template/apps/start/src/server/users.ts +17 -0
  59. package/template/apps/start/src/start.ts +40 -0
  60. package/template/apps/start/src/styles.css +2 -0
  61. package/template/apps/start/tsconfig.json +19 -0
  62. package/template/apps/start/vite.config.ts +27 -0
  63. package/template/apps/web/package.json +2 -2
  64. package/template/{scripts → apps/web/scripts}/start-standalone.mjs +1 -2
  65. package/template/clubedge.template.json +17 -1
  66. package/template/e2e/app.ts +12 -0
  67. package/template/{apps/web/e2e → e2e}/auth.spec.ts +2 -2
  68. package/template/eslint.config.mjs +4 -0
  69. package/template/package.json +3 -3
  70. package/template/packages/auth/package.json +1 -1
  71. package/template/packages/cache/package.json +1 -1
  72. package/template/packages/core/package.json +1 -1
  73. package/template/packages/db/package.json +1 -1
  74. package/template/packages/storage/package.json +1 -1
  75. package/template/packages/ui/package.json +1 -1
  76. package/template/playwright.config.ts +6 -2
  77. package/template/pnpm-lock.yaml +1382 -19
  78. package/template/turbo.json +1 -1
  79. package/template/vitest.config.ts +2 -0
  80. package/template.lock.json +50 -5
  81. /package/template/{apps/web/e2e → e2e}/home.spec.ts +0 -0
@@ -0,0 +1,39 @@
1
+ import "@tanstack/react-start/server-only";
2
+ import type { StorageProvider } from "@clubedge/storage";
3
+ import { createS3Storage } from "@clubedge/storage/s3";
4
+ import { createSupabaseStorage } from "@clubedge/storage/supabase";
5
+ import { getServerEnv } from "@/env/server";
6
+ import { getSupabaseClient } from "./auth";
7
+
8
+ export type { SignedUrlOptions, StorageProvider, UploadInput } from "@clubedge/storage";
9
+
10
+ let provider: StorageProvider | undefined;
11
+
12
+ function resolveProvider(): StorageProvider {
13
+ if (provider) return provider;
14
+ const env = getServerEnv();
15
+ provider =
16
+ env.STORAGE_PROVIDER === "supabase"
17
+ ? createSupabaseStorage({
18
+ bucket: env.SUPABASE_STORAGE_BUCKET || undefined,
19
+ getClient: getSupabaseClient,
20
+ })
21
+ : createS3Storage({
22
+ bucket: env.STORAGE_BUCKET || undefined,
23
+ region: env.STORAGE_REGION,
24
+ endpoint: env.STORAGE_ENDPOINT || undefined,
25
+ accessKeyId: env.STORAGE_ACCESS_KEY_ID || undefined,
26
+ secretAccessKey: env.STORAGE_SECRET_ACCESS_KEY || undefined,
27
+ publicUrl: env.STORAGE_PUBLIC_URL || undefined,
28
+ });
29
+ return provider;
30
+ }
31
+
32
+ /** The configured storage provider, resolved on first use so imports stay side-effect free. */
33
+ export const storage: StorageProvider = {
34
+ upload: (input) => resolveProvider().upload(input),
35
+ download: (key) => resolveProvider().download(key),
36
+ delete: (key) => resolveProvider().delete(key),
37
+ exists: (key) => resolveProvider().exists(key),
38
+ getSignedUrl: (key, options) => resolveProvider().getSignedUrl(key, options),
39
+ };
@@ -0,0 +1,17 @@
1
+ import "@tanstack/react-start/server-only";
2
+ import type { AuthUser } from "@clubedge/auth";
3
+ import { upsertUserProfile } from "@clubedge/db";
4
+ import { getDb } from "./db";
5
+
6
+ /**
7
+ * Keeps the app-owned users row in step with the identity provider. Failures are logged
8
+ * rather than thrown so a database outage does not block an otherwise valid sign-in.
9
+ */
10
+ export async function ensureUserProfile(user: AuthUser | null): Promise<void> {
11
+ if (!user?.email) return;
12
+ try {
13
+ await upsertUserProfile(getDb(), { authUserId: user.id, email: user.email });
14
+ } catch (error) {
15
+ console.error("Could not sync the user profile", error);
16
+ }
17
+ }
@@ -0,0 +1,40 @@
1
+ import { createCsrfMiddleware, createMiddleware, createStart } from "@tanstack/react-start";
2
+ import { refreshAuthSession } from "@/server/auth";
3
+
4
+ const securityHeaders: Record<string, string> = {
5
+ "X-Content-Type-Options": "nosniff",
6
+ "X-Frame-Options": "DENY",
7
+ "Referrer-Policy": "strict-origin-when-cross-origin",
8
+ "Permissions-Policy": "camera=(), microphone=(), geolocation=()",
9
+ "Strict-Transport-Security": "max-age=63072000; includeSubDomains; preload",
10
+ };
11
+
12
+ const safeMethods = new Set(["GET", "HEAD", "OPTIONS"]);
13
+
14
+ // Rejects cross-site form posts and server function calls (Next.js does this for actions).
15
+ const csrfProtection = createCsrfMiddleware({
16
+ filter: ({ request }) => !safeMethods.has(request.method),
17
+ });
18
+
19
+ // Refreshed cookies reach both later handlers in this request and the browser response.
20
+ const sessionRefresh = createMiddleware().server(async ({ next }) => {
21
+ await refreshAuthSession();
22
+ return next();
23
+ });
24
+
25
+ const responseHeaders = createMiddleware().server(async ({ next }) => {
26
+ const result = await next();
27
+ let response = result.response;
28
+ try {
29
+ for (const [name, value] of Object.entries(securityHeaders)) response.headers.set(name, value);
30
+ } catch {
31
+ // Some responses have immutable headers; copy them into a mutable response.
32
+ response = new Response(response.body, response);
33
+ for (const [name, value] of Object.entries(securityHeaders)) response.headers.set(name, value);
34
+ }
35
+ return { ...result, response };
36
+ });
37
+
38
+ export const startInstance = createStart(() => ({
39
+ requestMiddleware: [responseHeaders, csrfProtection, sessionRefresh],
40
+ }));
@@ -0,0 +1,2 @@
1
+ @import "@clubedge/ui/globals.css";
2
+ @source "./";
@@ -0,0 +1,19 @@
1
+ {
2
+ "extends": "../../tsconfig.base.json",
3
+ "compilerOptions": {
4
+ "lib": ["dom", "dom.iterable", "esnext"],
5
+ "jsx": "react-jsx",
6
+ "types": ["node", "vite/client"],
7
+ "baseUrl": ".",
8
+ "paths": {
9
+ "@/*": ["./src/*"]
10
+ }
11
+ },
12
+ "include": [
13
+ "**/*.ts",
14
+ "**/*.tsx",
15
+ "../../packages/ui/src/**/*.ts",
16
+ "../../packages/ui/src/**/*.tsx"
17
+ ],
18
+ "exclude": ["node_modules", ".output", ".nitro", ".tanstack", "dist"]
19
+ }
@@ -0,0 +1,27 @@
1
+ import tailwindcss from "@tailwindcss/vite";
2
+ import { tanstackStart } from "@tanstack/react-start/plugin/vite";
3
+ import viteReact from "@vitejs/plugin-react";
4
+ import { nitro } from "nitro/vite";
5
+ import { defineConfig, loadEnv } from "vite";
6
+
7
+ export default defineConfig(({ mode }) => {
8
+ // Server code reads process.env. Load .env, .env.local and friends from this directory so
9
+ // local development behaves like the Next.js app; real environment variables still win.
10
+ for (const [key, value] of Object.entries(loadEnv(mode, import.meta.dirname, ""))) {
11
+ process.env[key] ??= value;
12
+ }
13
+
14
+ return {
15
+ // Listen on every interface like `next dev`, so http://127.0.0.1:3000 (used by the
16
+ // browser tests) works where localhost resolves to IPv6 only.
17
+ server: { port: 3000, host: true },
18
+ resolve: { tsconfigPaths: true },
19
+ // TanStack Router and Base UI use this CommonJS package, which calls require("react").
20
+ // Inlined into the SSR build, that call survives as a runtime require of a second React
21
+ // copy and breaks hooks. Keeping it external lets Nitro bundle it with the one React.
22
+ // Vite resolves externals from this app, so it is also a direct dependency here.
23
+ environments: { ssr: { resolve: { external: ["use-sync-external-store"] } } },
24
+ // The Start plugin must come before the React plugin.
25
+ plugins: [tailwindcss(), tanstackStart(), nitro(), viteReact()],
26
+ };
27
+ });
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "@clubedge/web",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "scripts": {
7
7
  "dev": "next dev",
8
8
  "build": "next build",
9
- "start": "node ../../scripts/start-standalone.mjs",
9
+ "start": "node scripts/start-standalone.mjs",
10
10
  "typecheck": "tsc --noEmit"
11
11
  },
12
12
  "dependencies": {
@@ -3,8 +3,7 @@ import { spawn } from "node:child_process";
3
3
  import { fileURLToPath } from "node:url";
4
4
  import path from "node:path";
5
5
 
6
- const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
7
- const webRoot = path.join(repoRoot, "apps", "web");
6
+ const webRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
8
7
  const standaloneRoot = path.join(webRoot, ".next", "standalone", "apps", "web");
9
8
 
10
9
  await mkdir(path.join(standaloneRoot, ".next"), { recursive: true });
@@ -1,13 +1,29 @@
1
1
  {
2
- "schemaVersion": 1,
2
+ "schemaVersion": 2,
3
3
  "name": "clubedge-starter",
4
4
  "packageManager": "pnpm",
5
5
  "app": "apps/web",
6
+ "appPackage": "@clubedge/web",
6
7
  "siteConfig": "apps/web/src/config/site.json",
7
8
  "env": {
8
9
  "example": ".env.example",
9
10
  "target": "apps/web/.env.local"
10
11
  },
11
12
  "dockerImage": "clubedge-starter",
13
+ "defaultFramework": "next",
14
+ "frameworks": {
15
+ "next": {
16
+ "name": "Next.js",
17
+ "app": "apps/web",
18
+ "envExample": ".env.example",
19
+ "dockerfile": "Dockerfile"
20
+ },
21
+ "tanstack-start": {
22
+ "name": "TanStack Start",
23
+ "app": "apps/start",
24
+ "envExample": "apps/start/.env.example",
25
+ "dockerfile": "apps/start/Dockerfile"
26
+ }
27
+ },
12
28
  "exclude": ["clubedge.template.json", "scripts/template-manifest.test.ts"]
13
29
  }
@@ -0,0 +1,12 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+
4
+ // The app under test: apps/<E2E_APP>, defaulting to apps/web. Playwright compiles this file
5
+ // to CommonJS, so __dirname is available and paths work from any working directory.
6
+ const directory = join(__dirname, "..", "apps", process.env.E2E_APP ?? "web");
7
+ const readJson = (file: string) => JSON.parse(readFileSync(join(directory, file), "utf8"));
8
+
9
+ export const e2eApp = {
10
+ packageName: readJson("package.json").name as string,
11
+ site: readJson("src/config/site.json") as { serviceId: string },
12
+ };
@@ -1,5 +1,5 @@
1
1
  import { expect, test } from "@playwright/test";
2
- import site from "../src/config/site.json";
2
+ import { e2eApp } from "./app";
3
3
 
4
4
  // The browser suite runs without Supabase credentials, so these checks cover the
5
5
  // unconfigured mode: pages stay explorable and redirects stay on this origin.
@@ -33,5 +33,5 @@ test("login explains the rate limit error", async ({ page }) => {
33
33
  test("health endpoint reports the configured service id", async ({ request }) => {
34
34
  const health = await request.get("/api/health");
35
35
  expect(health.ok()).toBeTruthy();
36
- expect(await health.json()).toMatchObject({ status: "ok", service: site.serviceId });
36
+ expect(await health.json()).toMatchObject({ status: "ok", service: e2eApp.site.serviceId });
37
37
  });
@@ -52,6 +52,10 @@ export default defineConfig([
52
52
  globalIgnores([
53
53
  "**/node_modules/**",
54
54
  "**/.next/**",
55
+ "**/.output/**",
56
+ "**/.nitro/**",
57
+ "**/.tanstack/**",
58
+ "**/routeTree.gen.ts",
55
59
  "**/.turbo/**",
56
60
  ".pnpm-store/**",
57
61
  "out/**",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clubedge-starter-v1",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "packageManager": "pnpm@10.9.0",
@@ -9,8 +9,8 @@
9
9
  },
10
10
  "scripts": {
11
11
  "dev": "turbo run dev --filter=@clubedge/web",
12
- "build": "turbo run build --filter=@clubedge/web",
13
- "start": "node scripts/start-standalone.mjs",
12
+ "build": "turbo run build",
13
+ "start": "pnpm --filter @clubedge/web start",
14
14
  "lint": "eslint .",
15
15
  "typecheck": "turbo run typecheck",
16
16
  "format": "prettier --write .",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clubedge/auth",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clubedge/cache",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clubedge/core",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clubedge/db",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clubedge/storage",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@clubedge/ui",
3
- "version": "0.3.0",
3
+ "version": "0.4.0",
4
4
  "private": true,
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -1,18 +1,22 @@
1
1
  import { defineConfig, devices } from "@playwright/test";
2
+ import { e2eApp } from "./e2e/app";
2
3
 
4
+ // One browser suite for every framework. E2E_APP picks the app (defaults to apps/web).
3
5
  export default defineConfig({
4
- testDir: "./apps/web/e2e",
6
+ testDir: "./e2e",
5
7
  fullyParallel: true,
6
8
  reporter: "list",
7
9
  use: { baseURL: "http://127.0.0.1:3000", trace: "on-first-retry" },
8
10
  projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"] } }],
9
11
  webServer: {
10
- command: "pnpm --filter @clubedge/web dev",
12
+ command: `pnpm --filter ${e2eApp.packageName} dev`,
11
13
  url: "http://127.0.0.1:3000",
12
14
  reuseExistingServer: !process.env.CI,
13
15
  env: {
14
16
  DATABASE_URL: "postgresql://postgres:postgres@127.0.0.1:5432/postgres",
17
+ // Next.js reads NEXT_PUBLIC_APP_URL; TanStack Start reads APP_URL.
15
18
  NEXT_PUBLIC_APP_URL: "http://127.0.0.1:3000",
19
+ APP_URL: "http://127.0.0.1:3000",
16
20
  NODE_ENV: "development",
17
21
  },
18
22
  },