create-faas-app 8.0.0-beta.35 → 8.0.0-beta.36

package/README.md

@@ -4,6 +4,8 @@ Create a new FaasJS app from a curated starter template.
 
 FaasJS is optimized for database-driven React business applications. `create-faas-app` gives new projects a working starting point for the official path instead of asking every team to assemble React, API, database, testing, and UI conventions from scratch.
 
+This is the key difference from a generic React starter: the default template is shaped around complete business features. A feature is expected to connect UI, typed APIs, validation, PostgreSQL migrations, table types, and tests in one reviewable application slice.
+
 ## Quick Start
 
 ```bash
@@ -51,7 +53,7 @@ It is useful for learning the core FaasJS runtime, building API-only or BFF-styl
 
 Start with `admin` unless you have a specific reason not to. It shows how FaasJS expects complete application slices to fit together:
 
-- UI pages call typed APIs
+- feature UI calls typed APIs
 - APIs validate inputs at system boundaries
 - APIs use PostgreSQL through the shared database workflow
 - migrations and table types keep data contracts explicit
@@ -59,6 +61,8 @@ Start with `admin` unless you have a specific reason not to. It shows how FaasJS
 
 FaasJS allows teams to replace parts of the stack, but the templates, docs, and examples optimize this curated path first.
 
+Use `minimal` only when you intentionally want to step away from that path, such as for an API-only service, a BFF that will be paired with a separate frontend, or an app that needs a custom UI/database stack from day one.
+
 ## Auth And Permissions
 
 Authentication and permissions are intentionally not built into FaasJS core because production auth requirements vary by product.

package/dist/index.mjs

@@ -6,7 +6,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import enquirer from "enquirer";
 //#region package.json
-var version = "8.0.0-beta.34";
+var version = "8.0.0-beta.35";
 //#endregion
 //#region src/action/index.ts
 const prompt = enquirer.prompt;
@@ -82,6 +82,7 @@ async function action(options = {}) {
 		secret: generateSessionSecret()
 	}, templateName);
 	execSync(`cd ${answers.name} && npm install`, { stdio: "inherit" });
+	execSync(`cd ${answers.name} && npm run types`, { stdio: "inherit" });
 	execSync(`cd ${answers.name} && npm run test`, { stdio: "inherit" });
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-faas-app",
-  "version": "8.0.0-beta.35",
+  "version": "8.0.0-beta.36",
   "homepage": "https://faasjs.com/doc/create-faas-app",
   "bugs": {
     "url": "https://github.com/faasjs/faasjs/issues"

package/template/admin/package.json

@@ -7,6 +7,7 @@
     "dev": "vp dev",
     "build": "vp build",
     "start": "node --import @faasjs/node-utils/register-hooks server.ts",
+    "types": "faas types",
     "test": "vp test",
     "db:new": "faasjs-pg new",
     "db:status": "faasjs-pg status",

package/template/admin/src/.faasjs/types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by @faasjs/dev.
+ *
+ * Do not edit this file manually.
+ */
+import type { InferFaasAction } from '@faasjs/types'
+
+declare module '@faasjs/types' {
+  interface FaasActions {
+    "features/auth/api/me": InferFaasAction<typeof import("../features/auth/api/me.api")>
+    "features/users/api/create": InferFaasAction<typeof import("../features/users/api/create.api")>
+    "features/users/api/detail": InferFaasAction<typeof import("../features/users/api/detail.api")>
+    "features/users/api/list": InferFaasAction<typeof import("../features/users/api/list.api")>
+    "features/users/api/update": InferFaasAction<typeof import("../features/users/api/update.api")>
+  }
+}

package/template/admin/src/{pages/home/api/auth → features/auth/api}/__tests__/me.test.ts

@@ -3,7 +3,7 @@ import { describe, expect, it } from 'vitest'
 
 import api from '../me.api'
 
-describe('pages/home/api/auth/me', () => {
+describe('features/auth/api/me', () => {
   it('returns the current user from the auth plugin demo', async () => {
     const handler = testApi(api)
 

package/template/admin/src/{pages/home/api/auth → features/auth/api}/me.api.ts

@@ -1,7 +1,7 @@
 import { defineApi, HttpError } from '@faasjs/core'
 import { z } from '@faasjs/utils'
 
-import { AuthPlugin } from '../../../../plugins/auth'
+import { AuthPlugin } from '../../../plugins/auth'
 
 const api = defineApi({
   schema: z.object({}).strict(),

package/template/admin/src/{pages/home/api/users → features/users/api}/__tests__/create.test.ts

@@ -4,7 +4,7 @@ import { describe, expect, it } from 'vitest'
 
 import api from '../create.api'
 
-describe('pages/home/api/users/create', () => {
+describe('features/users/api/create', () => {
   it('creates a user with the shared pg bootstrap', async () => {
     const handler = testApi(api)
 

package/template/admin/src/{pages/home/api/users → features/users/api}/__tests__/detail.test.ts

@@ -4,7 +4,7 @@ import { describe, expect, it } from 'vitest'
 
 import api from '../detail.api'
 
-describe('pages/home/api/users/detail', () => {
+describe('features/users/api/detail', () => {
   it('returns one user', async () => {
     const client = await getClient()
     const [created] = await client.query('users').insert(

package/template/admin/src/{pages/home/api/users → features/users/api}/__tests__/list.test.ts

@@ -4,7 +4,7 @@ import { describe, expect, it } from 'vitest'
 
 import api from '../list.api'
 
-describe('pages/home/api/users/list', () => {
+describe('features/users/api/list', () => {
   it('lists users with total count', async () => {
     const client = await getClient()
 

package/template/admin/src/{pages/home/api/users → features/users/api}/__tests__/update.test.ts

@@ -4,7 +4,7 @@ import { describe, expect, it } from 'vitest'
 
 import api from '../update.api'
 
-describe('pages/home/api/users/update', () => {
+describe('features/users/api/update', () => {
   it('updates one user', async () => {
     const client = await getClient()
     const [created] = await client.query('users').insert(

package/template/admin/src/{pages/home → features/users}/index.tsx

@@ -1,35 +1,10 @@
-declare module '@faasjs/types' {
-  interface FaasActions {
-    '/pages/home/api/users/list': {
-      Params: { limit: number }
-      Data: { total?: number; rows?: { id: number; name: string }[] }
-    }
-    '/pages/home/api/users/create': {
-      Params: { name?: string | undefined }
-      Data: { message?: string; total?: number; user?: { id: number; name: string } }
-    }
-    '/pages/home/api/users/update': {
-      Params: { id: number; name: string }
-      Data: { message?: string; user?: { id: number; name: string } }
-    }
-    '/pages/home/api/users/detail': {
-      Params: { id: number }
-      Data: { user?: { id: number; name: string } }
-    }
-    '/pages/home/api/auth/me': {
-      Params: Record<string, never>
-      Data: { current_user?: { id: number; name: string; role: string } }
-    }
-  }
-}
-
 import { faas, useApp } from '@faasjs/ant-design'
 import { useFaas } from '@faasjs/react'
 import { toErrorMessage } from '@faasjs/utils'
 import { Button, Card, Input, Space, Table, Typography } from 'antd'
 import { useState } from 'react'
 
-export default function HomePage() {
+export default function UsersPage() {
   const app = useApp()
   const [name, setName] = useState('FaasJS')
   const [messageText, setMessageText] = useState('Create your first user through the FaasJS API')
@@ -38,7 +13,7 @@ export default function HomePage() {
     data: listData,
     loading: listLoading,
     reload,
-  } = useFaas('/pages/home/api/users/list', { limit: 10 })
+  } = useFaas('features/users/api/list', { limit: 10 })
 
   const rows = listData?.rows || []
 
@@ -46,7 +21,7 @@ export default function HomePage() {
   const callApi = async () => {
     setCreating(true)
     try {
-      const response = await faas('/pages/home/api/users/create', {
+      const response = await faas('features/users/api/create', {
         name: name.trim() || undefined,
       })
       const result = response.data
@@ -75,7 +50,7 @@ export default function HomePage() {
     setAuthLoading(true)
     try {
       const response = await faas(
-        '/pages/home/api/auth/me',
+        'features/auth/api/me',
         {},
         {
           headers: { authorization: 'Bearer demo-admin' },
@@ -137,7 +112,7 @@ export default function HomePage() {
               Load users slice
             </Button>
             <Button type="primary" loading={creating} onClick={callApi}>
-              Create /pages/home/api/users/create
+              Create features/users/api/create
             </Button>
             <Button loading={authLoading} onClick={callAuthDemo}>
               Call auth plugin demo

package/template/admin/src/main.tsx

@@ -1,7 +1,7 @@
 import { App } from '@faasjs/ant-design'
 import { createRoot } from 'react-dom/client'
 
-import HomePage from './pages/home'
+import UsersPage from './features/users'
 
 createRoot(document.getElementById('root') as HTMLElement).render(
   <App
@@ -20,6 +20,6 @@ createRoot(document.getElementById('root') as HTMLElement).render(
       },
     }}
   >
-    <HomePage />
+    <UsersPage />
   </App>,
 )

package/template/admin/tsconfig.json

@@ -1,4 +1,4 @@
 {
   "extends": "@faasjs/types/tsconfig/build.json",
-  "include": ["src", "vite.config.ts", "server.ts"]
+  "include": ["src", "src/.faasjs/types.d.ts", "vite.config.ts", "server.ts"]
 }

package/template/minimal/package.json

@@ -7,6 +7,7 @@
     "dev": "vp dev",
     "build": "vp build",
     "start": "node --import @faasjs/node-utils/register-hooks server.ts",
+    "types": "faas types",
     "test": "vp test"
   },
   "devDependencies": {

package/template/minimal/src/.faasjs/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by @faasjs/dev.
+ *
+ * Do not edit this file manually.
+ */
+import type { InferFaasAction } from '@faasjs/types'
+
+declare module '@faasjs/types' {
+  interface FaasActions {
+    "features/home/api/hello": InferFaasAction<typeof import("../features/home/api/hello.api")>
+  }
+}

package/template/minimal/src/{pages → features}/home/api/__tests__/hello.test.ts

@@ -3,7 +3,7 @@ import { describe, it, expect } from 'vitest'
 
 import api from '../hello.api'
 
-describe('pages/home/api/hello', () => {
+describe('features/home/api/hello', () => {
   it('should work', async () => {
     const handler = testApi(api)
 

package/template/minimal/src/{pages → features}/home/index.tsx

@@ -1,12 +1,3 @@
-declare module '@faasjs/types' {
-  interface FaasActions {
-    '/pages/home/api/hello': {
-      Params: { name?: string | undefined }
-      Data: { message?: string }
-    }
-  }
-}
-
 import { useState } from 'react'
 
 import { useFaas } from '../../react-client'
@@ -15,7 +6,7 @@ export default function HomePage() {
   const [name, setName] = useState('FaasJS')
 
   const { data, loading, reload } = useFaas(
-    '/pages/home/api/hello',
+    'features/home/api/hello',
     { name: name.trim() || undefined },
     { skip: true },
   )
@@ -39,7 +30,7 @@ export default function HomePage() {
         onClick={() => reload({ name: name.trim() || undefined })}
         disabled={loading}
       >
-        {loading ? 'Loading...' : 'Call /pages/home/api/hello'}
+        {loading ? 'Loading...' : 'Call features/home/api/hello'}
       </button>
     </main>
   )

package/template/minimal/src/main.tsx

@@ -1,5 +1,5 @@
 import { createRoot } from 'react-dom/client'
 
-import HomePage from './pages/home'
+import HomePage from './features/home'
 
 createRoot(document.getElementById('root') as HTMLElement).render(<HomePage />)

package/template/minimal/tsconfig.json

@@ -1,4 +1,4 @@
 {
   "extends": "@faasjs/types/tsconfig/build.json",
-  "include": ["src", "vite.config.ts", "server.ts"]
+  "include": ["src", "src/.faasjs/types.d.ts", "vite.config.ts", "server.ts"]
 }