create-keystone-app 7.0.2 → 8.0.1

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

@@ -44,7 +44,7 @@ var terminalLink__default = /*#__PURE__*/_interopDefault(terminalLink);
 
 var currentPkgJson = {
 	name: "create-keystone-app",
-	version: "7.0.2",
+	version: "8.0.1",
 	main: "dist/create-keystone-app.cjs.js",
 	files: [
 		"dist",
@@ -73,11 +73,9 @@ async function checkVersion() {
     const {
       version
     } = await getPackageJson__default["default"]('create-keystone-app');
-
     if (typeof version !== 'string') {
       throw new Error('version from package metadata was expected to be a string but was not');
     }
-
     if (semver__namespace.lt(currentPkgJson.version, version)) {
       console.error(`⚠️  You're running an old version of create-keystone-app, please update to ${version}`);
     }
@@ -94,16 +92,13 @@ const cli = meow__default["default"](`
 Usage
   $ create-keystone-app [directory]
 `);
-
 const versionInfo = () => {
   process.stdout.write('\n');
   console.log(`✨ You're about to generate a project using ${c__default["default"].bold('Keystone 6')} packages.
 `);
 };
-
 async function normalizeArgs() {
   let directory = cli.input[0];
-
   if (!directory) {
     ({
       directory
@@ -115,15 +110,12 @@ async function normalizeArgs() {
     }));
     process.stdout.write('\n');
   }
-
   return {
     directory: path__default["default"].resolve(directory)
   };
 }
-
 const installDeps = async cwd => {
   const spinner = ora__default["default"]('Installing dependencies with yarn. This may take a few minutes.').start();
-
   try {
     await execa__default["default"]('yarn', ['install'], {
       cwd
@@ -132,12 +124,10 @@ const installDeps = async cwd => {
     return 'yarn';
   } catch (_err) {
     let err = _err;
-
     if (err.failed) {
       process.stdout.write('\n');
       spinner.warn('Failed to install with yarn.');
       spinner.start('Installing dependencies with npm. This may take a few minutes.');
-
       try {
         await execa__default["default"]('npm', ['install'], {
           cwd
@@ -147,15 +137,12 @@ const installDeps = async cwd => {
         spinner.fail('Failed to install with npm.');
         throw npmErr;
       }
-
       process.stdout.write('\n');
       return 'npm';
     }
-
     throw err;
   }
 };
-
 (async () => {
   versionInfo();
   await checkVersion();
@@ -187,6 +174,5 @@ const installDeps = async cwd => {
   } else {
     console.error(err);
   }
-
   process.exit(1);
 });

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

@@ -44,7 +44,7 @@ var terminalLink__default = /*#__PURE__*/_interopDefault(terminalLink);
 
 var currentPkgJson = {
 	name: "create-keystone-app",
-	version: "7.0.2",
+	version: "8.0.1",
 	main: "dist/create-keystone-app.cjs.js",
 	files: [
 		"dist",
@@ -73,11 +73,9 @@ async function checkVersion() {
     const {
       version
     } = await getPackageJson__default["default"]('create-keystone-app');
-
     if (typeof version !== 'string') {
       throw new Error('version from package metadata was expected to be a string but was not');
     }
-
     if (semver__namespace.lt(currentPkgJson.version, version)) {
       console.error(`⚠️  You're running an old version of create-keystone-app, please update to ${version}`);
     }
@@ -94,16 +92,13 @@ const cli = meow__default["default"](`
 Usage
   $ create-keystone-app [directory]
 `);
-
 const versionInfo = () => {
   process.stdout.write('\n');
   console.log(`✨ You're about to generate a project using ${c__default["default"].bold('Keystone 6')} packages.
 `);
 };
-
 async function normalizeArgs() {
   let directory = cli.input[0];
-
   if (!directory) {
     ({
       directory
@@ -115,15 +110,12 @@ async function normalizeArgs() {
     }));
     process.stdout.write('\n');
   }
-
   return {
     directory: path__default["default"].resolve(directory)
   };
 }
-
 const installDeps = async cwd => {
   const spinner = ora__default["default"]('Installing dependencies with yarn. This may take a few minutes.').start();
-
   try {
     await execa__default["default"]('yarn', ['install'], {
       cwd
@@ -132,12 +124,10 @@ const installDeps = async cwd => {
     return 'yarn';
   } catch (_err) {
     let err = _err;
-
     if (err.failed) {
       process.stdout.write('\n');
       spinner.warn('Failed to install with yarn.');
       spinner.start('Installing dependencies with npm. This may take a few minutes.');
-
       try {
         await execa__default["default"]('npm', ['install'], {
           cwd
@@ -147,15 +137,12 @@ const installDeps = async cwd => {
         spinner.fail('Failed to install with npm.');
         throw npmErr;
       }
-
       process.stdout.write('\n');
       return 'npm';
     }
-
     throw err;
   }
 };
-
 (async () => {
   versionInfo();
   await checkVersion();
@@ -187,6 +174,5 @@ const installDeps = async cwd => {
   } else {
     console.error(err);
   }
-
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-keystone-app",
-  "version": "7.0.2",
+  "version": "8.0.1",
   "main": "dist/create-keystone-app.cjs.js",
   "files": [
     "dist",

package/starter/.keystone/config.js

@@ -0,0 +1,135 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// keystone.ts
+var keystone_exports = {};
+__export(keystone_exports, {
+  default: () => keystone_default
+});
+module.exports = __toCommonJS(keystone_exports);
+var import_core2 = require("@keystone-6/core");
+
+// schema.ts
+var import_core = require("@keystone-6/core");
+var import_access = require("@keystone-6/core/access");
+var import_fields = require("@keystone-6/core/fields");
+var import_fields_document = require("@keystone-6/fields-document");
+var lists = {
+  User: (0, import_core.list)({
+    access: import_access.allowAll,
+    fields: {
+      name: (0, import_fields.text)({ validation: { isRequired: true } }),
+      email: (0, import_fields.text)({
+        validation: { isRequired: true },
+        isIndexed: "unique"
+      }),
+      password: (0, import_fields.password)({ validation: { isRequired: true } }),
+      posts: (0, import_fields.relationship)({ ref: "Post.author", many: true }),
+      createdAt: (0, import_fields.timestamp)({
+        defaultValue: { kind: "now" }
+      })
+    }
+  }),
+  Post: (0, import_core.list)({
+    access: import_access.allowAll,
+    fields: {
+      title: (0, import_fields.text)({ validation: { isRequired: true } }),
+      content: (0, import_fields_document.document)({
+        formatting: true,
+        layouts: [
+          [1, 1],
+          [1, 1, 1],
+          [2, 1],
+          [1, 2],
+          [1, 2, 1]
+        ],
+        links: true,
+        dividers: true
+      }),
+      author: (0, import_fields.relationship)({
+        ref: "User.posts",
+        ui: {
+          displayMode: "cards",
+          cardFields: ["name", "email"],
+          inlineEdit: { fields: ["name", "email"] },
+          linkToItem: true,
+          inlineConnect: true
+        },
+        many: false
+      }),
+      tags: (0, import_fields.relationship)({
+        ref: "Tag.posts",
+        many: true,
+        ui: {
+          displayMode: "cards",
+          cardFields: ["name"],
+          inlineEdit: { fields: ["name"] },
+          linkToItem: true,
+          inlineConnect: true,
+          inlineCreate: { fields: ["name"] }
+        }
+      })
+    }
+  }),
+  Tag: (0, import_core.list)({
+    access: import_access.allowAll,
+    ui: {
+      isHidden: true
+    },
+    fields: {
+      name: (0, import_fields.text)(),
+      posts: (0, import_fields.relationship)({ ref: "Post.tags", many: true })
+    }
+  })
+};
+
+// auth.ts
+var import_crypto = require("crypto");
+var import_auth = require("@keystone-6/auth");
+var import_session = require("@keystone-6/core/session");
+var sessionSecret = process.env.SESSION_SECRET;
+if (!sessionSecret && true) {
+  sessionSecret = (0, import_crypto.randomBytes)(32).toString("hex");
+}
+var { withAuth } = (0, import_auth.createAuth)({
+  listKey: "User",
+  identityField: "email",
+  sessionData: "name createdAt",
+  secretField: "password",
+  initFirstItem: {
+    fields: ["name", "email", "password"]
+  }
+});
+var sessionMaxAge = 60 * 60 * 24 * 30;
+var session = (0, import_session.statelessSessions)({
+  maxAge: sessionMaxAge,
+  secret: sessionSecret
+});
+
+// keystone.ts
+var keystone_default = withAuth(
+  (0, import_core2.config)({
+    db: {
+      provider: "sqlite",
+      url: "file:./keystone.db"
+    },
+    lists,
+    session
+  })
+);

package/starter/auth.ts

@@ -1,51 +1,63 @@
-/*
-Welcome to the auth file! Here we have put a config to do basic auth in Keystone.
-
-`createAuth` is an implementation for an email-password login out of the box.
-`statelessSessions` is a base implementation of session logic.
-
-For more on auth, check out: https://keystonejs.com/docs/apis/auth#authentication-api
-*/
+// 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 'crypto';
 import { createAuth } from '@keystone-6/auth';
 
-// See https://keystonejs.com/docs/apis/session#session-api for the session docs
+// see https://keystonejs.com/docs/apis/session for the session docs
 import { statelessSessions } from '@keystone-6/core/session';
 
+// for a stateless session, a SESSION_SECRET should always be provided
+//   especially in production (statelessSessions will throw if SESSION_SECRET is undefined)
 let sessionSecret = process.env.SESSION_SECRET;
-
-// Here is a best practice! It's fine to not have provided a session secret in dev,
-// however it should always be there in production.
-if (!sessionSecret) {
-  if (process.env.NODE_ENV === 'production') {
-    throw new Error(
-      'The SESSION_SECRET environment variable must be set in production'
-    );
-  } else {
-    sessionSecret = '-- DEV COOKIE SECRET; CHANGE ME --';
-  }
+if (!sessionSecret && process.env.NODE_ENV !== 'production') {
+  sessionSecret = randomBytes(32).toString('hex');
 }
 
-// Here we define how auth relates to our schemas.
-// What we are saying here is that we want to use the list `User`, and to log in
-// we will need their email and password.
+// withAuth is a function we can use to wrap our base configuration
 const { withAuth } = createAuth({
   listKey: 'User',
   identityField: 'email',
-  sessionData: 'name',
+
+  // 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, keystone will ask you to create
-    // a new user, filling in these fields.
+    // 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
   },
 });
 
-// This defines how long people will remain logged in for.
-// This will get refreshed when they log back in.
-let sessionMaxAge = 60 * 60 * 24 * 30; // 30 days
+// 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;
 
-// This defines how sessions should work. For more details, check out: https://keystonejs.com/docs/apis/session#session-api
+// you can find out more at https://keystonejs.com/docs/apis/session#session-api
 const session = statelessSessions({
   maxAge: sessionMaxAge,
   secret: sessionSecret!,

package/starter/keystone.ts

@@ -1,32 +1,28 @@
-/*
-Welcome to Keystone! This file is what keystone uses to start the app.
-
-It looks at the default export, and expects a Keystone config object.
-
-You can find all the config options in our docs here: https://keystonejs.com/docs/apis/config
-*/
+// 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';
 
-// Look in the schema file for how we define our lists, and how users interact with them through graphql or the Admin UI
+// to keep this file tidy, we define our schema in a different file
 import { lists } from './schema';
 
-// Keystone auth is configured separately - check out the basic auth setup we are importing from our auth file.
+// 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(
-  // Using the config function helps typescript guide you to the available options.
   config({
-    // the db sets the database provider - we're using sqlite for the fastest startup experience
     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',
     },
-    // This config allows us to set up features of the Admin UI https://keystonejs.com/docs/apis/config#ui
-    ui: {
-      // For our starter, we check that someone has session data before letting them see the Admin UI.
-      isAccessAllowed: (context) => !!context.session?.data,
-    },
     lists,
     session,
   })

package/starter/package.json

@@ -9,21 +9,9 @@
     "postinstall": "keystone postinstall"
   },
   "dependencies": {
-    "@keystone-6/auth": "^4.0.0",
-    "@keystone-6/core": "^2.1.0",
-    "@keystone-6/fields-document": "^4.0.1",
-    "graphql": "^15.8.0",
-    "next": "12.2.4",
-    "typescript": "^4.7.4"
-  },
-  "// npm": "this is a temporary workaround for npm users, see https://github.com/keystonejs/create-keystone-app/pull/350",
-  "overrides": {
-    "graphql": "^15.8.0",
-    "next": "12.2.4"
-  },
-  "// yarn": "this is a temporary workaround for yarn users, see https://github.com/keystonejs/create-keystone-app/pull/350",
-  "resolutions": {
-    "graphql": "^15.8.0",
-    "next": "12.2.4"
+    "@keystone-6/auth": "^5.0.0",
+    "@keystone-6/core": "^3.0.1",
+    "@keystone-6/fields-document": "^5.0.0",
+    "typescript": "^4.8.0"
   }
 }

package/starter/schema.graphql

@@ -6,19 +6,17 @@ type User {
   name: String
   email: String
   password: PasswordState
-  posts(
-    where: PostWhereInput! = {}
-    orderBy: [PostOrderByInput!]! = []
-    take: Int
-    skip: Int! = 0
-  ): [Post!]
+  posts(where: PostWhereInput! = {}, orderBy: [PostOrderByInput!]! = [], take: Int, skip: Int! = 0): [Post!]
   postsCount(where: PostWhereInput! = {}): Int
+  createdAt: DateTime
 }
 
 type PasswordState {
   isSet: Boolean!
 }
 
+scalar DateTime @specifiedBy(url: "https://datatracker.ietf.org/doc/html/rfc3339#section-5.6")
+
 input UserWhereUniqueInput {
   id: ID
   email: String
@@ -32,6 +30,7 @@ input UserWhereInput {
   name: StringFilter
   email: StringFilter
   posts: PostManyRelationFilter
+  createdAt: DateTimeNullableFilter
 }
 
 input IDFilter {
@@ -79,10 +78,22 @@ input PostManyRelationFilter {
   none: PostWhereInput
 }
 
+input DateTimeNullableFilter {
+  equals: DateTime
+  in: [DateTime!]
+  notIn: [DateTime!]
+  lt: DateTime
+  lte: DateTime
+  gt: DateTime
+  gte: DateTime
+  not: DateTimeNullableFilter
+}
+
 input UserOrderByInput {
   id: OrderDirection
   name: OrderDirection
   email: OrderDirection
+  createdAt: OrderDirection
 }
 
 enum OrderDirection {
@@ -95,6 +106,7 @@ input UserUpdateInput {
   email: String
   password: String
   posts: PostRelateToManyForUpdateInput
+  createdAt: DateTime
 }
 
 input PostRelateToManyForUpdateInput {
@@ -114,6 +126,7 @@ input UserCreateInput {
   email: String
   password: String
   posts: PostRelateToManyForCreateInput
+  createdAt: DateTime
 }
 
 input PostRelateToManyForCreateInput {
@@ -124,16 +137,9 @@ input PostRelateToManyForCreateInput {
 type Post {
   id: ID!
   title: String
-  status: String
   content: Post_content_Document
-  publishDate: DateTime
   author: User
-  tags(
-    where: TagWhereInput! = {}
-    orderBy: [TagOrderByInput!]! = []
-    take: Int
-    skip: Int! = 0
-  ): [Tag!]
+  tags(where: TagWhereInput! = {}, orderBy: [TagOrderByInput!]! = [], take: Int, skip: Int! = 0): [Tag!]
   tagsCount(where: TagWhereInput! = {}): Int
 }
 
@@ -141,9 +147,6 @@ type Post_content_Document {
   document(hydrateRelationships: Boolean! = false): JSON!
 }
 
-scalar DateTime
-  @specifiedBy(url: "https://datatracker.ietf.org/doc/html/rfc3339#section-5.6")
-
 input PostWhereUniqueInput {
   id: ID
 }
@@ -154,51 +157,10 @@ input PostWhereInput {
   NOT: [PostWhereInput!]
   id: IDFilter
   title: StringFilter
-  status: StringNullableFilter
-  publishDate: DateTimeNullableFilter
   author: UserWhereInput
   tags: TagManyRelationFilter
 }
 
-input StringNullableFilter {
-  equals: String
-  in: [String!]
-  notIn: [String!]
-  lt: String
-  lte: String
-  gt: String
-  gte: String
-  contains: String
-  startsWith: String
-  endsWith: String
-  not: NestedStringNullableFilter
-}
-
-input NestedStringNullableFilter {
-  equals: String
-  in: [String!]
-  notIn: [String!]
-  lt: String
-  lte: String
-  gt: String
-  gte: String
-  contains: String
-  startsWith: String
-  endsWith: String
-  not: NestedStringNullableFilter
-}
-
-input DateTimeNullableFilter {
-  equals: DateTime
-  in: [DateTime!]
-  notIn: [DateTime!]
-  lt: DateTime
-  lte: DateTime
-  gt: DateTime
-  gte: DateTime
-  not: DateTimeNullableFilter
-}
-
 input TagManyRelationFilter {
   every: TagWhereInput
   some: TagWhereInput
@@ -208,15 +170,11 @@ input TagManyRelationFilter {
 input PostOrderByInput {
   id: OrderDirection
   title: OrderDirection
-  status: OrderDirection
-  publishDate: OrderDirection
 }
 
 input PostUpdateInput {
   title: String
-  status: String
   content: JSON
-  publishDate: DateTime
   author: UserRelateToOneForUpdateInput
   tags: TagRelateToManyForUpdateInput
 }
@@ -241,9 +199,7 @@ input PostUpdateArgs {
 
 input PostCreateInput {
   title: String
-  status: String
   content: JSON
-  publishDate: DateTime
   author: UserRelateToOneForCreateInput
   tags: TagRelateToManyForCreateInput
 }
@@ -261,12 +217,7 @@ input TagRelateToManyForCreateInput {
 type Tag {
   id: ID!
   name: String
-  posts(
-    where: PostWhereInput! = {}
-    orderBy: [PostOrderByInput!]! = []
-    take: Int
-    skip: Int! = 0
-  ): [Post!]
+  posts(where: PostWhereInput! = {}, orderBy: [PostOrderByInput!]! = [], take: Int, skip: Int! = 0): [Post!]
   postsCount(where: PostWhereInput! = {}): Int
 }
 
@@ -306,10 +257,7 @@ input TagCreateInput {
 """
 The `JSON` scalar type represents JSON values as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf).
 """
-scalar JSON
-  @specifiedBy(
-    url: "http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf"
-  )
+scalar JSON @specifiedBy(url: "http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf")
 
 type Mutation {
   createUser(data: UserCreateInput!): User
@@ -331,18 +279,11 @@ type Mutation {
   deleteTag(where: TagWhereUniqueInput!): Tag
   deleteTags(where: [TagWhereUniqueInput!]!): [Tag]
   endSession: Boolean!
-  authenticateUserWithPassword(
-    email: String!
-    password: String!
-  ): UserAuthenticationWithPasswordResult
-  createInitialUser(
-    data: CreateInitialUserInput!
-  ): UserAuthenticationWithPasswordSuccess!
+  authenticateUserWithPassword(email: String!, password: String!): UserAuthenticationWithPasswordResult
+  createInitialUser(data: CreateInitialUserInput!): UserAuthenticationWithPasswordSuccess!
 }
 
-union UserAuthenticationWithPasswordResult =
-    UserAuthenticationWithPasswordSuccess
-  | UserAuthenticationWithPasswordFailure
+union UserAuthenticationWithPasswordResult = UserAuthenticationWithPasswordSuccess | UserAuthenticationWithPasswordFailure
 
 type UserAuthenticationWithPasswordSuccess {
   sessionToken: String!
@@ -360,28 +301,13 @@ input CreateInitialUserInput {
 }
 
 type Query {
-  users(
-    where: UserWhereInput! = {}
-    orderBy: [UserOrderByInput!]! = []
-    take: Int
-    skip: Int! = 0
-  ): [User!]
+  users(where: UserWhereInput! = {}, orderBy: [UserOrderByInput!]! = [], take: Int, skip: Int! = 0): [User!]
   user(where: UserWhereUniqueInput!): User
   usersCount(where: UserWhereInput! = {}): Int
-  posts(
-    where: PostWhereInput! = {}
-    orderBy: [PostOrderByInput!]! = []
-    take: Int
-    skip: Int! = 0
-  ): [Post!]
+  posts(where: PostWhereInput! = {}, orderBy: [PostOrderByInput!]! = [], take: Int, skip: Int! = 0): [Post!]
   post(where: PostWhereUniqueInput!): Post
   postsCount(where: PostWhereInput! = {}): Int
-  tags(
-    where: TagWhereInput! = {}
-    orderBy: [TagOrderByInput!]! = []
-    take: Int
-    skip: Int! = 0
-  ): [Tag!]
+  tags(where: TagWhereInput! = {}, orderBy: [TagOrderByInput!]! = [], take: Int, skip: Int! = 0): [Tag!]
   tag(where: TagWhereUniqueInput!): Tag
   tagsCount(where: TagWhereInput! = {}): Int
   keystone: KeystoneMeta!
@@ -395,8 +321,6 @@ type KeystoneMeta {
 }
 
 type KeystoneAdminMeta {
-  enableSignout: Boolean!
-  enableSessionItem: Boolean!
   lists: [KeystoneAdminUIListMeta!]!
   list(key: String!): KeystoneAdminUIListMeta
 }
@@ -418,6 +342,7 @@ type KeystoneAdminUIListMeta {
   fields: [KeystoneAdminUIFieldMeta!]!
   initialSort: KeystoneAdminUISort
   isHidden: Boolean!
+  isSingleton: Boolean
 }
 
 type KeystoneAdminUIFieldMeta {

package/starter/schema.prisma

@@ -13,22 +13,21 @@ generator client {
 }
 
 model User {
-  id       String @id @default(cuid())
-  name     String @default("")
-  email    String @unique @default("")
-  password String
-  posts    Post[] @relation("Post_author")
+  id        String    @id @default(cuid())
+  name      String    @default("")
+  email     String    @unique @default("")
+  password  String
+  posts     Post[]    @relation("Post_author")
+  createdAt DateTime? @default(now())
 }
 
 model Post {
-  id          String    @id @default(cuid())
-  title       String    @default("")
-  status      String?   @default("draft")
-  content     String    @default("[{\"type\":\"paragraph\",\"children\":[{\"text\":\"\"}]}]")
-  publishDate DateTime?
-  author      User?     @relation("Post_author", fields: [authorId], references: [id])
-  authorId    String?   @map("author")
-  tags        Tag[]     @relation("Post_tags")
+  id       String  @id @default(cuid())
+  title    String  @default("")
+  content  String  @default("[{\"type\":\"paragraph\",\"children\":[{\"text\":\"\"}]}]")
+  author   User?   @relation("Post_author", fields: [authorId], references: [id])
+  authorId String? @map("author")
+  tags     Tag[]   @relation("Post_tags")
 
   @@index([authorId])
 }
@@ -37,4 +36,4 @@ model Tag {
   id    String @id @default(cuid())
   name  String @default("")
   posts Post[] @relation("Post_tags")
-}
+}

package/starter/schema.ts

@@ -1,24 +1,15 @@
-/*
-Welcome to the schema! The schema is the heart of Keystone.
+// 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
 
-Here we define our 'lists', which will then be used both for the GraphQL
-API definition, our database tables, and our Admin UI layout.
-
-Some quick definitions to help out:
-A list: A definition of a collection of fields with a name. For the starter
-  we have `User`, `Post`, and `Tag` lists.
-A field: The individual bits of data on your list, each with its own type.
-  you can see some of the lists in what we use below.
-
-*/
-
-// Like the `config` function we use in keystone.ts, we use functions
-// for putting in our config so we get useful errors. With typescript,
-// we get these even before code runs.
 import { list } from '@keystone-6/core';
+import { allowAll } from '@keystone-6/core/access';
 
-// We're using some common fields in the starter. Check out https://keystonejs.com/docs/apis/fields#fields-api
-// for the full list of fields.
+// 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,
@@ -26,69 +17,62 @@ import {
   timestamp,
   select,
 } from '@keystone-6/core/fields';
-// The document field is a more complicated field, so it's in its own package
-// Keystone aims to have all the base field types, but you can make your own
-// custom ones.
+
+// 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
 
-// We are using Typescript, and we want our types experience to be as strict as it can be.
-// By providing the Keystone generated `Lists` type to our lists object, we refine
-// our types to a stricter subset that is type-aware of other lists in our schema
-// that Typescript cannot easily infer.
-import { Lists } from '.keystone/types';
+// 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';
 
-// We have a users list, a blogs list, and tags for blog posts, so they can be filtered.
-// Each property on the exported object will become the name of a list (a.k.a. the `listKey`),
-// with the value being the definition of the list, including the fields.
 export const lists: Lists = {
-  // Here we define the user list.
   User: list({
-    // Here are the fields that `User` will have. We want an email and password so they can log in
-    // a name so we can refer to them, and a way to connect users to posts.
+    // 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',
-        isFilterable: true,
       }),
-      // The password field takes care of hiding details and hashing values
+
       password: password({ validation: { isRequired: true } }),
-      // Relationships allow us to reference other lists. In this case,
-      // we want a user to have many posts, and we are saying that the user
-      // should be referencable by the 'author' field of posts.
-      // Make sure you read the docs to understand how they work: https://keystonejs.com/docs/guides/relationships#understanding-relationships
+
+      // 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 }),
-    },
-    // Here we can configure the Admin UI. We want to show a user's name and posts in the Admin UI
-    ui: {
-      listView: {
-        initialColumns: ['name', 'posts'],
-      },
+
+      createdAt: timestamp({
+        // this sets the timestamp to Date.now() when the user is first created
+        defaultValue: { kind: 'now' },
+      }),
     },
   }),
-  // Our second list is the Posts list. We've got a few more fields here
-  // so we have all the info we need for displaying posts.
+
   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(),
-      // Having the status here will make it easy for us to choose whether to display
-      // posts on a live site.
-      status: select({
-        options: [
-          { label: 'Published', value: 'published' },
-          { label: 'Draft', value: 'draft' },
-        ],
-        // We want to make sure new posts start off as a draft when they are created
-        defaultValue: 'draft',
-        // fields also have the ability to configure their appearance in the Admin UI
-        ui: {
-          displayMode: 'segmented-control',
-        },
-      }),
-      // The document field can be used for making highly editable content. Check out our
-      // guide on the document field https://keystonejs.com/docs/guides/document-fields#how-to-use-document-fields
-      // for more information
+      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: [
@@ -101,11 +85,13 @@ export const lists: Lists = {
         links: true,
         dividers: true,
       }),
-      publishDate: timestamp(),
-      // Here is the link from post => author.
-      // We've configured its UI display quite a lot to make the experience of editing posts better.
+
+      // 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'],
@@ -113,10 +99,21 @@ export const lists: Lists = {
           linkToItem: true,
           inlineConnect: true,
         },
+
+        // a Post can only have one author
+        //   this is the default, but we show it here for verbosity
+        many: false,
       }),
-      // We also link posts to tags. This is a many <=> many linking.
+
+      // 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'],
@@ -125,17 +122,27 @@ export const lists: Lists = {
           inlineConnect: true,
           inlineCreate: { fields: ['name'] },
         },
-        many: true,
       }),
     },
   }),
-  // Our final list is the tag list. This field is just a name and a relationship to posts
+
+  // 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,
+
+    // setting this to isHidden for the user interface prevents this list being visible in the Admin UI
     ui: {
       isHidden: 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 }),
     },
   }),