create-keystone-app 0.0.0-rc-20250210004303

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Thinkmill Labs Pty Ltd
+
+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,10 @@
+# create-keystone-app
+
+<br>
+<p>Keystone helps you build faster and scale further than any other CMS or App Framework. Describe your schema, and get a powerful GraphQL API & beautiful Management UI for your content and data.</p>
+<p>No boilerplate or bootstrapping – just elegant APIs to help you ship the code that matters without sacrificing the flexibility or power of a bespoke back-end.
+</p>
+
+For help with this package join the conversation in [Slack](https://community.keystonejs.com/), or on [GitHub](https://github.com/keystonejs/keystone/).
+
+Visit <https://keystonejs.com/> for docs, and [follow @keystonejs on Twitter](https://twitter.com/keystonejs) for the latest updates.

package/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import './dist/create-keystone-app.esm.js'

package/dist/create-keystone-app.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlLWtleXN0b25lLWFwcC5janMuZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4vZGVjbGFyYXRpb25zL3NyYy9pbmRleC5kLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBIn0=

package/dist/create-keystone-app.cjs.js

@@ -0,0 +1,133 @@
+'use strict';
+
+var fs = require('node:fs/promises');
+var path = require('node:path');
+var node_url = require('node:url');
+var c = require('chalk');
+var enquirer = require('enquirer');
+var execa = require('execa');
+var getPackageJson = require('package-json');
+var meow = require('meow');
+var ora = require('ora');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { 'default': e }; }
+
+var fs__default = /*#__PURE__*/_interopDefault(fs);
+var path__default = /*#__PURE__*/_interopDefault(path);
+var c__default = /*#__PURE__*/_interopDefault(c);
+var enquirer__default = /*#__PURE__*/_interopDefault(enquirer);
+var execa__default = /*#__PURE__*/_interopDefault(execa);
+var getPackageJson__default = /*#__PURE__*/_interopDefault(getPackageJson);
+var meow__default = /*#__PURE__*/_interopDefault(meow);
+var ora__default = /*#__PURE__*/_interopDefault(ora);
+
+var thisPackage = {
+	name: "create-keystone-app",
+	version: "0.0.0-rc-20250210004303",
+	license: "MIT",
+	type: "module",
+	main: "dist/create-keystone-app.cjs.js",
+	module: "dist/create-keystone-app.esm.js",
+	repository: "https://github.com/keystonejs/keystone/tree/main/packages/create",
+	bin: "./cli.js",
+	exports: {
+		".": {
+			types: "./dist/create-keystone-app.cjs.js",
+			module: "./dist/create-keystone-app.esm.js",
+			"default": "./dist/create-keystone-app.cjs.js"
+		},
+		"./package.json": "./package.json"
+	},
+	preconstruct: {
+		entrypoints: [
+			"index.ts"
+		]
+	},
+	dependencies: {
+		chalk: "^4.1.2",
+		enquirer: "^2.4.1",
+		execa: "^5.1.1",
+		meow: "^9.0.0",
+		ora: "^8.0.1",
+		"package-json": "^10.0.0"
+	},
+	files: [
+		"dist",
+		"starter",
+		"cli.js"
+	]
+};
+
+async function checkVersion() {
+  const {
+    version: upstream
+  } = await getPackageJson__default["default"]('create-keystone-app');
+  if (upstream === thisPackage.version) return;
+  console.error(`⚠️  You're running an old version of create-keystone-app, please update to ${upstream}`);
+}
+class UserError extends Error {}
+const __dirname$1 = path__default["default"].dirname(node_url.fileURLToPath((typeof document === 'undefined' ? new (require('u' + 'rl').URL)('file:' + __filename).href : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT' && document.currentScript.src || new URL('dist/create-keystone-app.cjs.js', document.baseURI).href))));
+const starterDir = path__default["default"].normalize(`${__dirname$1}/../starter`);
+const cli = meow__default["default"](`
+Usage
+  $ create-keystone-app [directory]
+`);
+async function normalizeArgs() {
+  let directory = cli.input[0];
+  if (!directory) {
+    ({
+      directory
+    } = await enquirer__default["default"].prompt({
+      type: 'input',
+      name: 'directory',
+      message: 'What directory should create-keystone-app generate your app into?',
+      validate: x => !!x
+    }));
+    process.stdout.write('\n');
+  }
+  return {
+    directory: path__default["default"].resolve(directory)
+  };
+}
+(async (_process$env$npm_conf, _process$env$npm_conf2) => {
+  process.stdout.write('\n');
+  console.log(`✨ You're about to generate a project using ${c__default["default"].bold('Keystone 6')} packages.`);
+  await checkVersion();
+  const normalizedArgs = await normalizeArgs();
+  const nextCwd = normalizedArgs.directory;
+  await fs__default["default"].mkdir(nextCwd);
+  await Promise.all(['_gitignore', 'schema.ts', 'package.json', 'tsconfig.json', 'keystone.ts', 'auth.ts', 'README.md'].map(filename => fs__default["default"].copyFile(path__default["default"].join(starterDir, filename), path__default["default"].join(normalizedArgs.directory, filename.replace(/^_/, '.')))));
+  const [packageManager] = (_process$env$npm_conf = (_process$env$npm_conf2 = process.env.npm_config_user_agent) === null || _process$env$npm_conf2 === void 0 ? void 0 : _process$env$npm_conf2.split('/', 1)) !== null && _process$env$npm_conf !== void 0 ? _process$env$npm_conf : ['npm'];
+  const spinner = ora__default["default"](`Installing dependencies with ${packageManager}. This may take a few minutes.`).start();
+  try {
+    await execa__default["default"](packageManager, ['install'], {
+      cwd: nextCwd
+    });
+    spinner.succeed(`Installed dependencies with ${packageManager}.`);
+  } catch (err) {
+    spinner.fail(`Failed to install with ${packageManager}.`);
+    throw err;
+  }
+  const relativeProjectDir = path__default["default"].relative(process.cwd(), normalizedArgs.directory);
+  process.stdout.write('\n');
+  console.log(`🎉  Keystone created a starter project in: ${c__default["default"].bold(relativeProjectDir)}
+
+  ${c__default["default"].bold('To launch your app, run:')}
+
+  - cd ${relativeProjectDir}
+  - ${packageManager} run dev
+
+  ${c__default["default"].bold('Next steps:')}
+
+  - Read ${c__default["default"].bold(`${relativeProjectDir}${path__default["default"].sep}README.md`)} for additional getting started details.
+  - Edit ${c__default["default"].bold(`${relativeProjectDir}${path__default["default"].sep}keystone.ts`)} to customize your app.
+  - Star Keystone on GitHub (https://github.com/keystonejs/keystone)
+`);
+})().catch(err => {
+  if (err instanceof UserError) {
+    console.error(err.message);
+  } else {
+    console.error(err);
+  }
+  process.exit(1);
+});

package/dist/create-keystone-app.esm.js

@@ -0,0 +1,120 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import c from 'chalk';
+import enquirer from 'enquirer';
+import execa from 'execa';
+import getPackageJson from 'package-json';
+import meow from 'meow';
+import ora from 'ora';
+
+var thisPackage = {
+	name: "create-keystone-app",
+	version: "0.0.0-rc-20250210004303",
+	license: "MIT",
+	type: "module",
+	main: "dist/create-keystone-app.cjs.js",
+	module: "dist/create-keystone-app.esm.js",
+	repository: "https://github.com/keystonejs/keystone/tree/main/packages/create",
+	bin: "./cli.js",
+	exports: {
+		".": {
+			types: "./dist/create-keystone-app.cjs.js",
+			module: "./dist/create-keystone-app.esm.js",
+			"default": "./dist/create-keystone-app.cjs.js"
+		},
+		"./package.json": "./package.json"
+	},
+	preconstruct: {
+		entrypoints: [
+			"index.ts"
+		]
+	},
+	dependencies: {
+		chalk: "^4.1.2",
+		enquirer: "^2.4.1",
+		execa: "^5.1.1",
+		meow: "^9.0.0",
+		ora: "^8.0.1",
+		"package-json": "^10.0.0"
+	},
+	files: [
+		"dist",
+		"starter",
+		"cli.js"
+	]
+};
+
+async function checkVersion() {
+  const {
+    version: upstream
+  } = await getPackageJson('create-keystone-app');
+  if (upstream === thisPackage.version) return;
+  console.error(`⚠️  You're running an old version of create-keystone-app, please update to ${upstream}`);
+}
+class UserError extends Error {}
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const starterDir = path.normalize(`${__dirname}/../starter`);
+const cli = meow(`
+Usage
+  $ create-keystone-app [directory]
+`);
+async function normalizeArgs() {
+  let directory = cli.input[0];
+  if (!directory) {
+    ({
+      directory
+    } = await enquirer.prompt({
+      type: 'input',
+      name: 'directory',
+      message: 'What directory should create-keystone-app generate your app into?',
+      validate: x => !!x
+    }));
+    process.stdout.write('\n');
+  }
+  return {
+    directory: path.resolve(directory)
+  };
+}
+(async (_process$env$npm_conf, _process$env$npm_conf2) => {
+  process.stdout.write('\n');
+  console.log(`✨ You're about to generate a project using ${c.bold('Keystone 6')} packages.`);
+  await checkVersion();
+  const normalizedArgs = await normalizeArgs();
+  const nextCwd = normalizedArgs.directory;
+  await fs.mkdir(nextCwd);
+  await Promise.all(['_gitignore', 'schema.ts', 'package.json', 'tsconfig.json', 'keystone.ts', 'auth.ts', 'README.md'].map(filename => fs.copyFile(path.join(starterDir, filename), path.join(normalizedArgs.directory, filename.replace(/^_/, '.')))));
+  const [packageManager] = (_process$env$npm_conf = (_process$env$npm_conf2 = process.env.npm_config_user_agent) === null || _process$env$npm_conf2 === void 0 ? void 0 : _process$env$npm_conf2.split('/', 1)) !== null && _process$env$npm_conf !== void 0 ? _process$env$npm_conf : ['npm'];
+  const spinner = ora(`Installing dependencies with ${packageManager}. This may take a few minutes.`).start();
+  try {
+    await execa(packageManager, ['install'], {
+      cwd: nextCwd
+    });
+    spinner.succeed(`Installed dependencies with ${packageManager}.`);
+  } catch (err) {
+    spinner.fail(`Failed to install with ${packageManager}.`);
+    throw err;
+  }
+  const relativeProjectDir = path.relative(process.cwd(), normalizedArgs.directory);
+  process.stdout.write('\n');
+  console.log(`🎉  Keystone created a starter project in: ${c.bold(relativeProjectDir)}
+
+  ${c.bold('To launch your app, run:')}
+
+  - cd ${relativeProjectDir}
+  - ${packageManager} run dev
+
+  ${c.bold('Next steps:')}
+
+  - Read ${c.bold(`${relativeProjectDir}${path.sep}README.md`)} for additional getting started details.
+  - Edit ${c.bold(`${relativeProjectDir}${path.sep}keystone.ts`)} to customize your app.
+  - Star Keystone on GitHub (https://github.com/keystonejs/keystone)
+`);
+})().catch(err => {
+  if (err instanceof UserError) {
+    console.error(err.message);
+  } else {
+    console.error(err);
+  }
+  process.exit(1);
+});

package/dist/declarations/src/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/declarations/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "create-keystone-app",
+  "version": "0.0.0-rc-20250210004303",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/create-keystone-app.cjs.js",
+  "module": "dist/create-keystone-app.esm.js",
+  "repository": "https://github.com/keystonejs/keystone/tree/main/packages/create",
+  "bin": "./cli.js",
+  "exports": {
+    ".": {
+      "types": "./dist/create-keystone-app.cjs.js",
+      "module": "./dist/create-keystone-app.esm.js",
+      "default": "./dist/create-keystone-app.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "preconstruct": {
+    "entrypoints": [
+      "index.ts"
+    ]
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "enquirer": "^2.4.1",
+    "execa": "^5.1.1",
+    "meow": "^9.0.0",
+    "ora": "^8.0.1",
+    "package-json": "^10.0.0"
+  },
+  "files": [
+    "dist",
+    "starter",
+    "cli.js"
+  ]
+}

package/starter/README.md

@@ -0,0 +1,52 @@
+# Keystone Project Starter
+
+Welcome to Keystone!
+
+Run
+
+```
+npm run dev
+```
+
+To view the config for your new app, look at [./keystone.ts](./keystone.ts)
+
+This project starter is designed to give you a sense of the power Keystone can offer you, and show off some of its main features. It's also a pretty simple setup if you want to build out from it.
+
+We recommend you use this alongside our [getting started walkthrough](https://keystonejs.com/docs/walkthroughs/getting-started-with-create-keystone-app) which will walk you through what you get as part of this starter.
+
+If you want an overview of all the features Keystone offers, check out our [features](https://keystonejs.com/why-keystone#features) page.
+
+## Some Quick Notes On Getting Started
+
+### Changing the database
+
+We've set you up with an [SQLite database](https://keystonejs.com/docs/apis/config#sqlite) for ease-of-use. If you're wanting to use PostgreSQL, you can!
+
+Just change the `db` property on line 16 of the Keystone file [./keystone.ts](./keystone.ts) to
+
+```typescript
+db: {
+    provider: 'postgresql',
+    url: process.env.DATABASE_URL || 'DATABASE_URL_TO_REPLACE',
+}
+```
+
+And provide your database url from PostgreSQL.
+
+For more on database configuration, check out or [DB API Docs](https://keystonejs.com/docs/apis/config#db)
+
+### Auth
+
+We've put auth into its own file to make this humble starter easier to navigate. To explore it without auth turned on, comment out the `isAccessAllowed` on line 21 of the Keystone file [./keystone.ts](./keystone.ts).
+
+For more on auth, check out our [Authentication API Docs](https://keystonejs.com/docs/apis/auth#authentication-api)
+
+### Adding a frontend
+
+As a Headless CMS, Keystone can be used with any frontend that uses GraphQL. It provides a GraphQL endpoint you can write queries against at `/api/graphql` (by default [http://localhost:3000/api/graphql](http://localhost:3000/api/graphql)). At Thinkmill, we tend to use [Next.js](https://nextjs.org/) and [Apollo GraphQL](https://www.apollographql.com/docs/react/get-started/) as our frontend and way to write queries, but if you have your own favourite, feel free to use it.
+
+A walkthrough on how to do this is forthcoming, but in the meantime our [todo example](https://github.com/keystonejs/keystone-react-todo-demo) shows a Keystone set up with a frontend. For a more full example, you can also look at an example app we built for [Prisma Day 2021](https://github.com/keystonejs/prisma-day-2021-workshop)
+
+### Embedding Keystone in a Next.js frontend
+
+While Keystone works as a standalone app, you can embed your Keystone app into a [Next.js](https://nextjs.org/) app. This is quite a different setup to the starter, and we recommend checking out our walkthrough for that [here](https://keystonejs.com/docs/walkthroughs/embedded-mode-with-sqlite-nextjs#how-to-embed-keystone-sq-lite-in-a-next-js-app).

package/starter/_gitignore

@@ -0,0 +1,4 @@
+node_modules
+.keystone/
+keystone.db
+*.log

package/starter/auth.ts

@@ -0,0 +1,59 @@
+// Welcome to some authentication for Keystone
+//
+// This is using @keystone-6/auth to add the following
+// - A sign-in page for your Admin UI
+// - A cookie-based stateless session strategy
+//    - Using a User email as the identifier
+//    - 30 day cookie expiration
+//
+// This file does not configure what Users can do, and the default for this starter
+// project is to allow anyone - logged-in or not - to do anything.
+//
+// If you want to prevent random people on the internet from accessing your data,
+// you can find out how by reading https://keystonejs.com/docs/guides/auth-and-access-control
+//
+// If you want to learn more about how our out-of-the-box authentication works, please
+// read https://keystonejs.com/docs/apis/auth#authentication-api
+
+import { randomBytes } from 'node:crypto'
+import { createAuth } from '@keystone-6/auth'
+
+// see https://keystonejs.com/docs/apis/session for the session docs
+import { statelessSessions } from '@keystone-6/core/session'
+
+// withAuth is a function we can use to wrap our base configuration
+const { withAuth } = createAuth({
+  listKey: 'User',
+  identityField: 'email',
+
+  // this is a GraphQL query fragment for fetching what data will be attached to a context.session
+  //   this can be helpful for when you are writing your access control functions
+  //   you can find out more at https://keystonejs.com/docs/guides/auth-and-access-control
+  sessionData: 'name createdAt',
+  secretField: 'password',
+
+  // WARNING: remove initFirstItem functionality in production
+  //   see https://keystonejs.com/docs/config/auth#init-first-item for more
+  initFirstItem: {
+    // if there are no items in the database, by configuring this field
+    //   you are asking the Keystone AdminUI to create a new user
+    //   providing inputs for these fields
+    fields: ['name', 'email', 'password'],
+
+    // it uses context.sudo() to do this, which bypasses any access control you might have
+    //   you shouldn't use this in production
+  },
+})
+
+// statelessSessions uses cookies for session tracking
+//   these cookies have an expiry, in seconds
+//   we use an expiry of 30 days for this starter
+const sessionMaxAge = 60 * 60 * 24 * 30
+
+// you can find out more at https://keystonejs.com/docs/apis/session#session-api
+const session = statelessSessions({
+  maxAge: sessionMaxAge,
+  secret: process.env.SESSION_SECRET,
+})
+
+export { withAuth, session }

package/starter/keystone.ts

@@ -0,0 +1,29 @@
+// Welcome to Keystone!
+//
+// This file is what Keystone uses as the entry-point to your headless backend
+//
+// Keystone imports the default export of this file, expecting a Keystone configuration object
+//   you can find out more at https://keystonejs.com/docs/apis/config
+
+import { config } from '@keystone-6/core'
+
+// to keep this file tidy, we define our schema in a different file
+import { lists } from './schema'
+
+// authentication is configured separately here too, but you might move this elsewhere
+// when you write your list-level access control functions, as they typically rely on session data
+import { withAuth, session } from './auth'
+
+export default withAuth(
+  config({
+    db: {
+      // we're using sqlite for the fastest startup experience
+      //   for more information on what database might be appropriate for you
+      //   see https://keystonejs.com/docs/guides/choosing-a-database#title
+      provider: 'sqlite',
+      url: 'file:./keystone.db',
+    },
+    lists,
+    session,
+  })
+)

package/starter/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "keystone-app",
+  "version": "1.0.3",
+  "private": true,
+  "scripts": {
+    "dev": "keystone dev",
+    "start": "keystone start",
+    "build": "keystone build"
+  },
+  "dependencies": {
+    "@keystone-6/auth": "^8.0.0",
+    "@keystone-6/core": "^6.0.0",
+    "@keystone-6/fields-document": "^9.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/starter/schema.ts

@@ -0,0 +1,150 @@
+// Welcome to your schema
+//   Schema driven development is Keystone's modus operandi
+//
+// This file is where we define the lists, fields and hooks for our data.
+// If you want to learn more about how lists are configured, please read
+// - https://keystonejs.com/docs/config/lists
+
+import { list } from '@keystone-6/core'
+import { allowAll } from '@keystone-6/core/access'
+
+// see https://keystonejs.com/docs/fields/overview for the full list of fields
+//   this is a few common fields for an example
+import {
+  text,
+  relationship,
+  password,
+  timestamp,
+  select,
+} from '@keystone-6/core/fields'
+
+// the document field is a more complicated field, so it has it's own package
+import { document } from '@keystone-6/fields-document'
+// if you want to make your own fields, see https://keystonejs.com/docs/guides/custom-fields
+
+// when using Typescript, you can refine your types to a stricter subset by importing
+// the generated types from '.keystone/types'
+import { type Lists } from '.keystone/types'
+
+export const lists = {
+  User: list({
+    // WARNING
+    //   for this starter project, anyone can create, query, update and delete anything
+    //   if you want to prevent random people on the internet from accessing your data,
+    //   you can find out more at https://keystonejs.com/docs/guides/auth-and-access-control
+    access: allowAll,
+
+    // this is the fields for our User list
+    fields: {
+      // by adding isRequired, we enforce that every User should have a name
+      //   if no name is provided, an error will be displayed
+      name: text({ validation: { isRequired: true } }),
+
+      email: text({
+        validation: { isRequired: true },
+        // by adding isIndexed: 'unique', we're saying that no user can have the same
+        // email as another user - this may or may not be a good idea for your project
+        isIndexed: 'unique',
+      }),
+
+      password: password({ validation: { isRequired: true } }),
+
+      // we can use this field to see what Posts this User has authored
+      //   more on that in the Post list below
+      posts: relationship({ ref: 'Post.author', many: true }),
+
+      createdAt: timestamp({
+        // this sets the timestamp to Date.now() when the user is first created
+        defaultValue: { kind: 'now' },
+      }),
+    },
+  }),
+
+  Post: list({
+    // WARNING
+    //   for this starter project, anyone can create, query, update and delete anything
+    //   if you want to prevent random people on the internet from accessing your data,
+    //   you can find out more at https://keystonejs.com/docs/guides/auth-and-access-control
+    access: allowAll,
+
+    // this is the fields for our Post list
+    fields: {
+      title: text({ validation: { isRequired: true } }),
+
+      // the document field can be used for making rich editable content
+      //   you can find out more at https://keystonejs.com/docs/guides/document-fields
+      content: document({
+        formatting: true,
+        layouts: [
+          [1, 1],
+          [1, 1, 1],
+          [2, 1],
+          [1, 2],
+          [1, 2, 1],
+        ],
+        links: true,
+        dividers: true,
+      }),
+
+      // with this field, you can set a User as the author for a Post
+      author: relationship({
+        // we could have used 'User', but then the relationship would only be 1-way
+        ref: 'User.posts',
+
+        // this is some customisations for changing how this will look in the AdminUI
+        ui: {
+          displayMode: 'cards',
+          cardFields: ['name', 'email'],
+          inlineEdit: { fields: ['name', 'email'] },
+          linkToItem: true,
+          inlineConnect: true,
+        },
+
+        // a Post can only have one author
+        //   this is the default, but we show it here for verbosity
+        many: false,
+      }),
+
+      // with this field, you can add some Tags to Posts
+      tags: relationship({
+        // we could have used 'Tag', but then the relationship would only be 1-way
+        ref: 'Tag.posts',
+
+        // a Post can have many Tags, not just one
+        many: true,
+
+        // this is some customisations for changing how this will look in the AdminUI
+        ui: {
+          displayMode: 'cards',
+          cardFields: ['name'],
+          inlineEdit: { fields: ['name'] },
+          linkToItem: true,
+          inlineConnect: true,
+          inlineCreate: { fields: ['name'] },
+        },
+      }),
+    },
+  }),
+
+  // this last list is our Tag list, it only has a name field for now
+  Tag: list({
+    // WARNING
+    //   for this starter project, anyone can create, query, update and delete anything
+    //
+    //   if you want to prevent random people on the internet from accessing your data,
+    //   you can find out more at https://keystonejs.com/docs/guides/auth-and-access-control
+    access: allowAll,
+
+    // dont show this list in the AdminUI
+    ui: {
+      hideNavigation: true,
+    },
+
+    // this is the fields for our Tag list
+    fields: {
+      name: text(),
+      // this can be helpful to find out all the Posts associated with a Tag
+      posts: relationship({ ref: 'Post.tags', many: true }),
+    },
+  }),
+} satisfies Lists

package/starter/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  }
+}