chore(release): v1.7.4

Co-authored-by: Dan Ribbens <dan.ribbens@gmail.com>

.editorconfig

@@ -4,7 +4,7 @@ charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 
-[*.js]
+[*.{js,ts,tsx}]
 indent_style = space
 indent_size = 2
 
@@ -15,3 +15,7 @@ indent_size = 2
 [*.scss]
 indent_style = space
 indent_size = 2
+
+[*.mdx]
+indent_style = space
+indent_size = 2

.eslintrc.js

@@ -1,15 +1,104 @@
 module.exports = {
-  parser: "babel-eslint",
-  extends: "@trbl",
-  rules: {
-    "import/no-unresolved": [
-      2,
-      {
-        ignore: [
-          'payload/config',
-          'payload/unsanitizedConfig',
-        ]
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+    ecmaFeatures: {
+      jsx: true,
+    },
+  },
+  plugins: [
+    '@typescript-eslint',
+  ],
+  extends: [
+    '@trbl',
+  ],
+  settings: {
+    'import/resolver': {
+      node: {
+        extensions: ['.js', '.jsx', '.ts', '.tsx'],
+      },
+    },
+  },
+  overrides: [
+    {
+      files: ['test/**/int.spec.ts'],
+      rules: {
+        '@typescript-eslint/no-use-before-define': 'off',
+        '@typescript-eslint/consistent-type-imports': 'warn',
+        'jest/prefer-strict-equal': 'off',
       }
+    },
+    {
+      files: ['test/**/e2e.spec.ts'],
+      extends: [
+        'plugin:playwright/playwright-test'
+      ],
+      rules: {
+        'jest/consistent-test-it': 'off',
+        'jest/require-top-level-describe': 'off',
+        'jest/no-test-callback': 'off',
+        'jest/prefer-strict-equal': 'off',
+        'jest/expect-expect': 'off',
+        'jest-dom/prefer-to-have-attribute': 'off',
+      }
+    },
+    {
+      files: ['*.ts', '*.tsx'],
+      parser: '@typescript-eslint/parser',
+      extends: [
+        'plugin:@typescript-eslint/recommended',
+      ],
+      rules: {
+        'no-shadow': 'off',
+        '@typescript-eslint/no-shadow': ['error'],
+        'import/no-unresolved': [
+          2,
+          {
+            ignore: [
+              'payload-config',
+              'payload/generated-types',
+            ],
+          },
+        ],
+      },
+    },
+    {
+      files: ['*.spec.ts'],
+      rules: {
+        '@typescript-eslint/no-use-before-define': 'off',
+      },
+    },
+    {
+      files: ['*.e2e.ts'],
+      rules: {
+        '@typescript-eslint/no-use-before-define': 'off',
+        'jest/expect-expect': 'off',
+      },
+    },
+  ],
+  rules: {
+    'import/no-extraneous-dependencies': ['error', { packageDir: './' }],
+    'react/jsx-filename-extension': [2, { extensions: ['.js', '.jsx', '.ts', '.tsx'] }],
+    'import/prefer-default-export': 'off',
+    'react/prop-types': 'off',
+    'react/require-default-props': 'off',
+    'react/no-unused-prop-types': 'off',
+    'no-console': 'warn',
+    'no-sparse-arrays': 'off',
+    'no-underscore-dangle': 'off',
+    'no-use-before-define': 'off',
+    'arrow-body-style': 0,
+    '@typescript-eslint/no-use-before-define': 'off',
+    'import/extensions': [
+      'error',
+      'ignorePackages',
+      {
+        js: 'never',
+        jsx: 'never',
+        ts: 'never',
+        tsx: 'never',
+      },
     ],
   },
 };

.github/ISSUE_TEMPLATE/1.bug_report.yml

@@ -0,0 +1,42 @@
+name: Bug Report
+description: Create a bug report for the Payload CMS
+labels: ["possible-bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        *Note:* Feature requests should be opened as [discussions](https://github.com/payloadcms/payload/discussions/new?category=feature-requests-ideas).
+  - type: input
+    id: reproduction-link
+    attributes:
+      label: Link to reproduction
+      description: Please add a link to a reproduction. See the fork [reproduction-guide](https://github.com/payloadcms/payload/blob/master/.github/reproduction-guide.md) for more information.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: To Reproduce
+      description: Steps to reproduce the behavior, please provide a clear description of how to reproduce the issue, based on the linked minimal reproduction. Screenshots can be provided in the issue body below. If using code blocks, make sure that [syntax highlighting is correct](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks#syntax-highlighting) and double check that the rendered preview is not broken.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Describe the Bug
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Payload Version
+      description: What version of Payload are you running?
+    validations:
+      required: true
+  - type: markdown
+    attributes:
+      value: Before submitting the issue, go through the steps you've written down to make sure the steps provided are detailed and clear.
+  - type: markdown
+    attributes:
+      value: Contributors should be able to follow the steps provided in order to reproduce the bug.
+  - type: markdown
+    attributes:
+      value: These steps are used to add integration tests to ensure the same issue does not happen again. Thanks in advance!

.github/ISSUE_TEMPLATE/DOCUMENTATION_ISSUE.md

@@ -0,0 +1,13 @@
+---
+name: Documentation Issue
+about: Suggest fix to Payload documentation
+labels: 'documentation'
+---
+
+# Documentation Issue
+
+<!--- Please provide a summary of the documentation issue -->
+
+## Additional Details
+
+<!--- Provide any other additional details -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Feature Request
+    url: https://github.com/payloadcms/payload/discussions
+    about: Suggest an idea to improve Payload in our GitHub Discussions
+  - name: Question about Payload
+    url: https://github.com/payloadcms/payload/discussions
+    about: Please ask Payload-related questions in our GitHub Discussions

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,20 @@
+## Description
+
+<!-- Please include a summary of the pull request and any related issues it fixes. Please also include relevant motivation and context. -->
+
+- [ ] I have read and understand the CONTRIBUTING.md document in this repository
+
+## Type of change
+
+<!-- Please delete options that are not relevant. -->
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] This change requires a documentation update
+
+## Checklist:
+
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] Existing test suite passes locally with my changes
+- [ ] I have made corresponding changes to the documentation

.github/reproduction-guide.md

@@ -0,0 +1,58 @@
+# Reproduction Guide
+
+1. [fork](https://github.com/payloadcms/payload/fork) this repo
+2. run `yarn` to install dependencies
+3. open up the `test/_community` directory
+4. add any necessary `collections/globals/fields` in this directory to recreate the issue you are experiencing
+5. run `yarn dev _community` to start the admin panel
+
+**NOTE:** The goal is to isolate the problem by reducing the number of `collections/globals/fields` you add to the `test/_community` folder. This folder is _not_ meant for you to copy your project into, but rather recreate the issue you are experiencing with minimal config.
+
+## Example test directory file tree
+```text
+.
+├── config.ts
+├── int.spec.ts
+├── e2e.spec.ts
+└── payload-types.ts
+```
+
+- `config.ts` - This is the _granular_ Payload config for testing. It should be as lightweight as possible. Reference existing configs for an example
+- `int.spec.ts` [Optional] - This is the test file run by jest. Any test file must have a `*int.spec.ts` suffix.
+- `e2e.spec.ts` [Optional] - This is the end-to-end test file that will load up the admin UI using the above config and run Playwright tests.
+- `payload-types.ts` - Generated types from `config.ts`. Generate this file by running `yarn dev:generate-types _community`.
+
+The directory split up in this way specifically to reduce friction when creating tests and to add the ability to boot up Payload with that specific config. You should modify the files in `test/_community` to get started.
+
+<br />
+
+## Testing is optional but encouraged
+An issue does not need to have failing tests — reproduction steps with your forked repo are enough at this point. Some people like to dive deeper and we want to give you the guidance/tools to do so. Read more below:
+
+### Running integration tests (Payload API tests)
+First install [Jest Runner for VSVode](https://marketplace.visualstudio.com/items?itemName=firsttris.vscode-jest-runner).
+
+There are a couple ways run integration tests:
+
+- **Granularly** - you can run individual tests in vscode by installing the Jest Runner plugin and using that to run individual tests. Clicking the `debug` button will run the test in debug mode allowing you to set break points.
+
+  <img src="https://raw.githubusercontent.com/payloadcms/payload/master/src/admin/assets/images/github/int-debug.png" />
+
+- **Manually** - you can run all int tests in the `/test/_community/int.spec.ts` file by running the following command:
+
+  ```bash
+  yarn test:int _community
+  ```
+
+### Running E2E tests (Admin Panel UI tests)
+The easiest way to run E2E tests is to install
+- [Playwright Test for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright)
+- [Playwright Runner](https://marketplace.visualstudio.com/items?itemName=ortoni.ortoni)
+
+Once they are installed you can open the `testing` tab in vscode sidebar and drill down to the test you want to run, i.e. `/test/_community/e2e.spec.ts`
+
+<img src="https://raw.githubusercontent.com/payloadcms/payload/master/src/admin/assets/images/github/e2e-debug.png" />
+
+
+#### Notes
+- It is recommended to add the test credentials (located in `test/credentials.ts`) to your autofill for `localhost:3000/admin` as this will be required on every nodemon restart. The default credentials are `dev@payloadcms.com` as email and `test` as password.

.github/workflows/tests.yml

@@ -1,30 +1,88 @@
-name: Node.js CI
+name: build
 
-on: [push]
+on:
+  pull_request:
+    types: [opened, reopened, edited, synchronize]
+  push:
+    branches: ["master"]
 
 jobs:
-  build:
+  build_yarn:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [10.x, 12.x]
+        node-version: [14.x, 16.x, 18.x]
 
     steps:
-    - uses: actions/checkout@v2
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v1
-      with:
-        node-version: ${{ matrix.node-version }}
-    - name: Cache node modules
-      uses: actions/cache@v1
-      with:
-        path: ~/.npm
-        key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
-        restore-keys: |
-          ${{ runner.os }}-build-${{ env.cache-name }}-
-          ${{ runner.os }}-build-
-          ${{ runner.os }}-
-    - run: yarn
-    - run: yarn test:int # In-memory db + api tests
-      env:
-        CI: true
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node-version }}
+          registry-url: https://registry.npmjs.org
+          scope: "@payloadcms"
+          always-auth: true
+      - name: Cache node modules
+        uses: actions/cache@v1
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-build-${{ env.cache-name }}-
+            ${{ runner.os }}-build-
+            ${{ runner.os }}-
+      - run: yarn
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - run: yarn build
+
+      - name: Component Tests
+        run: yarn test:components
+      - name: Integration Tests
+        run: yarn test:int
+
+      - name: Generate Payload Types
+        run: yarn dev:generate-types fields
+
+      - name: Generate GraphQL schema file
+        run: yarn dev:generate-graphql-schema
+
+      - name: Install Playwright Browsers
+        run: npx playwright install --with-deps
+      - name: E2E Tests
+        run: yarn test:e2e --bail
+
+      - uses: actions/upload-artifact@v3
+        if: always()
+        with:
+          name: test-results
+          path: test-results/
+          retention-days: 30
+
+  install_npm:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [16.x]
+
+    steps:
+      - uses: actions/checkout@v2
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v1
+        with:
+          node-version: ${{ matrix.node-version }}
+          registry-url: https://registry.npmjs.org
+          scope: "@payloadcms"
+          always-auth: true
+      - name: Cache node modules
+        uses: actions/cache@v1
+        with:
+          path: ~/.npm
+          key: ${{ runner.os }}-node-npm-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            ${{ runner.os }}-npm-${{ env.cache-name }}-
+            ${{ runner.os }}-npm-
+            ${{ runner.os }}-
+      - run: npm install --legacy-peer-deps
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -2,6 +2,7 @@ coverage
 package-lock.json
 dist
 .idea
+test-results
 
 # Created by https://www.gitignore.io/api/node,macos,windows,webstorm,sublimetext,visualstudiocode
 
@@ -86,6 +87,15 @@ typings/
 # Yarn Integrity file
 .yarn-integrity
 
+# Yarn Berry
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+.pnp.*
+
 # dotenv environment variables file
 .env
 
@@ -215,15 +225,20 @@ $RECYCLE.BIN/
 # Windows shortcuts
 *.lnk
 
-
 # End of https://www.gitignore.io/api/node,macos,windows,webstorm,sublimetext,visualstudiocode
 
-# Ignores compiled CSS
-src/**/*.css
-demo**/*.css
-dist
-
 # Ignore all uploads
 demo/upload
 demo/media
 demo/files
+
+# Ignore build folder
+build
+
+# Ignore built components
+components/index.js
+components/styles.css
+
+# Ignore generated
+demo/generated-types.ts
+demo/generated-schema.graphql

.node-version

@@ -0,0 +1 @@
+v16.14.2

.nvmrc

@@ -0,0 +1 @@
+v16.14.2

.release-it.json

@@ -0,0 +1,22 @@
+{
+  "verbose": true,
+  "git": {
+    "commitMessage": "chore(release): v${version}",
+    "requireCleanWorkingDir": true
+  },
+  "github": {
+    "release": true
+  },
+  "npm": {
+    "skipChecks": true
+  },
+  "hooks": {
+    "before:init": ["yarn", "yarn clean", "yarn test"]
+  },
+  "plugins": {
+    "@release-it/conventional-changelog": {
+      "preset": "angular",
+      "infile": "CHANGELOG.md"
+    }
+  }
+}

.release-it.pre.json

@@ -0,0 +1,25 @@
+{
+  "verbose": true,
+  "git": {
+    "requireCleanWorkingDir": false,
+    "commit": false,
+    "push": false,
+    "tag": false
+  },
+  "github": {
+    "release": false
+  },
+  "npm": {
+    "skipChecks": true,
+    "tag": "canary"
+  },
+  "hooks": {
+    "before:init": ["yarn", "yarn clean", "yarn test"]
+  },
+  "plugins": {
+    "@release-it/conventional-changelog": {
+      "preset": "angular",
+      "infile": "CHANGELOG.md"
+    }
+  }
+}

.vscode/launch.json

@@ -4,63 +4,18 @@
   // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
   "version": "0.2.0",
   "configurations": [
-    {
-      "name": "Debug Jest Tests",
-      "type": "node",
-      "request": "launch",
-      "runtimeArgs": [
-        "--inspect-brk",
-        "${workspaceRoot}/node_modules/.bin/jest",
-        "--runInBand"
-      ],
-      "env": {
-        "PAYLOAD_CONFIG_PATH": "demo/payload.config.js"
-      },
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen",
-      "port": 9229,
-      "skipFiles": [
-        "<node_internals>/**"
-      ]
-    },
-    {
-      "name": "Debug Jest Test - Current File",
-      "type": "node",
-      "request": "launch",
-      "runtimeArgs": [
-        "--inspect-brk",
-        "${workspaceRoot}/node_modules/.bin/jest",
-        "${fileBasename}",
-        "--runInBand"
-      ],
-      "env": {
-        "PAYLOAD_CONFIG_PATH": "demo/payload.config.js"
-      },
-      "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen",
-      "port": 9229,
-      "skipFiles": [
-        "<node_internals>/**"
-      ]
-    },
     {
       "type": "node",
       "request": "launch",
       "name": "Launch Program",
-      "env": {
-        "PAYLOAD_CONFIG_PATH": "demo/payload.config.js"
-      },
-      "program": "${workspaceFolder}/demo/server.js",
-      "skipFiles": [
-        "<node_internals>/**"
+      "runtimeArgs": [
+        "-r",
+        "ts-node/register"
+      ],
+      "args": [
+        "${workspaceFolder}/test/dev.ts",
+        "fields"
       ]
     },
-    {
-      "type": "chrome",
-      "request": "launch",
-      "name": "Launch Chrome against Localhost",
-      "url": "http://localhost:3000/admin",
-      "webRoot": "${workspaceFolder}"
-    }
   ]
 }

ISSUE_GUIDE.md

@@ -0,0 +1,64 @@
+# Reporting an issue
+
+To report an issue, please follow the steps below:
+
+1. Fork this repository
+2. Add necessary collections/globals/fields to the `test/_community` directory to recreate the issue you are experiencing
+3. Create an issue and add a link to your forked repo
+
+**The goal is to isolate the problem by reducing the number of fields/collections you add to the test/_community folder. This folder is not meant for you to copy your project into, but to recreate the issue you are experiencing with minimal config.**
+
+## Test directory file tree explanation
+```text
+.
+├── config.ts
+├── int.spec.ts
+├── e2e.spec.ts
+└── payload-types.ts
+```
+
+- `config.ts` - This is the _granular_ Payload config for testing. It should be as lightweight as possible. Reference existing configs for an example
+- `int.spec.ts` [Optional] - This is the test file run by jest. Any test file must have a `*int.spec.ts` suffix.
+- `e2e.spec.ts` [Optional] - This is the end-to-end test file that will load up the admin UI using the above config and run Playwright tests.
+- `payload-types.ts` - Generated types from `config.ts`. Generate this file by running `yarn dev:generate-types _community`.
+
+The directory split up in this way specifically to reduce friction when creating tests and to add the ability to boot up Payload with that specific config. You should modify the files in `test/_community` to get started.
+
+## How to start test collection admin UI
+To start the admin panel so you can manually recreate your issue, you can run the following command:
+
+  ```bash
+  # This command will start up Payload using your config
+  # NOTE: it will wipe the test database on restart
+  yarn dev _community
+  ```
+
+
+## Testing is optional but encouraged
+An issue does not need to have failing tests — reproduction steps with your forked repo are enough at this point. Some people like to dive deeper and we want to give you the guidance/tools to do so. Read more below.
+
+### How to run integration tests (Payload API tests)
+There are a couple ways to do this:
+
+- **Granularly** - you can run individual tests in vscode by installing the Jest Runner plugin and using that to run individual tests. Clicking the `debug` button will run the test in debug mode allowing you to set break points.
+
+  <img src="https://raw.githubusercontent.com/payloadcms/payload/master/src/admin/assets/images/github/int-debug.png" />
+
+- **Manually** - you can run all int tests in the `/test/_community/int.spec.ts` file by running the following command:
+
+  ```bash
+  yarn test:int _community
+  ```
+
+### How to run E2E tests (Admin Panel UI tests)
+The easiest way to run E2E tests is to install
+- [Playwright Test for VSCode](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright)
+- [Playwright Runner](https://marketplace.visualstudio.com/items?itemName=ortoni.ortoni)
+
+Once they are installed you can open the `testing` tab in vscode sidebar and drill down to the test you want to run, i.e. `/test/_community/e2e.spec.ts`
+
+<img src="https://raw.githubusercontent.com/payloadcms/payload/master/src/admin/assets/images/github/e2e-debug.png" />
+
+
+#### Notes
+- It is recommended to add the test credentials (located in `test/credentials.ts`) to your autofill for `localhost:3000/admin` as this will be required on every nodemon restart. The default credentials are `dev@payloadcms.com` as email and `test` as password.

README.md

@@ -1,21 +1,122 @@
-# Payload
+<p style="border: none; margin-bottom:0; padding-bottom: 0;" align="center">
+  <a href="https://payloadcms.com">
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/payloadcms/payload/master/src/admin/assets/images/payload-logo-light.svg">
+      <img width="350" alt="payload cms logo" src="https://raw.githubusercontent.com/payloadcms/payload/master/src/admin/assets/images/payload-logo-dark.svg">
+    </picture>
+  </a>
+</p>
 
-Headless CMS and application framework
+<h3 align="center">The most powerful TypeScript CMS</h3>
+<p align="center">Code-first Headless CMS that bridges the gap between CMS and application framework</p>
 
-*TODO: More on why to use it and some features*
+<h3 align="center">
+  <a target="_blank" href="https://payloadcms.com/docs/getting-started/what-is-payload" rel="dofollow"><strong>Explore the docs</strong></a>
+  ·
+  <a target="_blank" href="https://demo.payloadcms.com/" rel="dofollow"><strong>Try Live Demo</strong></a>
+  <br />
+</h3>
 
-## Installation
+<br />
 
-`yarn add @payloadcms/payload` or `npm install @payloadcms/payload`
+<p align="center">
+  <a href="https://opensource.org/licenses/MIT">
+    <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" />
+  </a>
+  &nbsp;
+  <a href="https://github.com/payloadcms/payload/actions">
+    <img alt="GitHub Workflow Status" src="https://img.shields.io/github/actions/workflow/status/payloadcms/payload/tests.yml?style=flat-square">
+  </a>
+  &nbsp;
+  <a href="https://github.com/payloadcms/payload/commits">
+    <img src="https://img.shields.io/github/commit-activity/m/payloadcms/payload?style=flat-square" alt="git commit activity"/>
+  </a>
+  &nbsp;
+  <a href="https://discord.com/invite/r6sCXqVk3v">
+    <img alt="Discord" src="https://img.shields.io/discord/967097582721572934?label=Discord&color=7289da&style=flat-square" />
+  </a>
+  &nbsp;
+  <a href="https://www.npmjs.com/package/payload">
+    <img alt="npm" src="https://img.shields.io/npm/v/payload?style=flat-square" />
+  </a>
+  &nbsp;
+  <a href="https://twitter.com/payloadcms">
+    <img src="https://img.shields.io/badge/follow-payloadcms-1DA1F2?logo=twitter&style=flat-square" alt="Payload CMS Twitter" />
+  </a>
+</p>
 
-## Usage
+<br />
 
-*TODO: Show basic usage and link to docs*
+<a href="https://payloadcms.com">
+  <img src="https://cms.payloadcms.com/media/payload-github-header.jpg" alt="Payload headless CMS Admin panel built with React" />
+</a>
 
-## Contributing
+<br />
 
-*TODO: Create Contributing.md*
+## ⭐ Why Payload?
 
-## License
+Payload is a CMS that has been designed for developers from the ground up to deliver them what they need to build great digital products. If you know JavaScript, you know Payload. It's a _code-first_ CMS, which allows us to do a lot of things right:
 
-*TODO: Create License.md*
+- Payload gives you everything you need, but then steps back and lets you build what you want in JavaScript or TypeScript - with no unnecessary complexity brought by GUIs. You'll understand how your CMS works because you will have written it exactly how you want it.
+- Bring your own Express server and do whatever you need on top of Payload. Payload doesn't impose anything on you or your app.
+- Completely control the Admin panel by using your own React components. Swap out fields or even entire views with ease.
+- Use your data however and wherever you need thanks to auto-generated, yet fully extensible REST, GraphQL, and Local Node APIs.
+
+<a target="_blank" href="https://payloadcms.com/" rel="dofollow"><strong>Read more on our website</strong></a>
+
+## ✨ Features
+
+- Completely free and open-source
+- [GraphQL](https://payloadcms.com/docs/graphql/overview), [REST](https://payloadcms.com/docs/rest-api/overview), and [Local](https://payloadcms.com/docs/local-api/overview) APIs
+- [Easily customizable ReactJS Admin](https://payloadcms.com/docs/admin/overview)
+- [Fully self-hosted](https://payloadcms.com/docs/production/deployment)
+- [Extensible Authentication](https://payloadcms.com/docs/authentication/overview)
+- [Local file storage & upload](https://payloadcms.com/docs/upload/overview)
+- [Version History and Drafts](https://payloadcms.com/docs/versions/overview)
+- [Field-based Localization](https://payloadcms.com/docs/configuration/localization)
+- [Block-based Layout Builder](https://payloadcms.com/docs/fields/blocks)
+- [Extensible SlateJS rich text editor](https://payloadcms.com/docs/fields/rich-text)
+- [Array field type](https://payloadcms.com/docs/fields/array)
+- [Field conditional logic](https://payloadcms.com/docs/fields/overview#conditional-logic)
+- Extremely granular [Access Control](https://payloadcms.com/docs/access-control/overview)
+- [Document and field-level hooks](https://payloadcms.com/docs/hooks/overview) for every action Payload provides
+- Built with Typescript & very Typescript-friendly
+- Intensely fast API
+- Highly secure thanks to HTTP-only cookies, CSRF protection, and more
+
+<a target="_blank" href="https://github.com/payloadcms/payload/discussions"><strong>Request Feature</strong></a>
+## 🚀 Quick Start
+
+Before beginning to work with Payload, make sure you have all of the [required software](https://payloadcms.com/docs/getting-started/installation).
+
+From there, the easiest way to get started with Payload is to use the `create-payload-app` package:
+
+```text
+npx create-payload-app
+```
+
+Alternatively, it only takes about five minutes to [create an app from scratch](https://payloadcms.com/docs/getting-started/installation#from-scratch).
+
+## 🗒️ Documentation
+
+Check out the [Payload website](https://payloadcms.com/docs/getting-started/what-is-payload) to find in-depth documentation for everything that Payload offers.
+
+## 🙋 Contributing
+
+If you want to add contributions to this repository, please follow the instructions in [contributing.md](./contributing.md).
+
+## 🚨 Need help?
+
+There are lots of good conversations and resources in our Github Discussions board & our Discord Server. If you're struggling with something, chances are, someone's already solved what you're up against. :point_down:
+
+- [GitHub Discussions](https://github.com/payloadcms/payload/discussions)
+- [GitHub Issues](https://github.com/payloadcms/payload/issues)
+- [Discord](https://t.co/30APlsQUPB)
+
+## ⭐ Like what we're doing? Give us a star
+
+![payload-github-star](https://cms.payloadcms.com/media/payload-github-star.gif)
+
+## 👏 Thanks to all our contributors
+
+<img align="left" src="https://contributors-img.web.app/image?repo=payloadcms/payload"/>

SECURITY.md

@@ -0,0 +1,5 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+Please report any security issues or concerns to [info@payloadcms.com](mailto:info@payloadcms.com).

auth.d.ts

@@ -0,0 +1 @@
+export * from './dist/auth';

auth.js

@@ -0,0 +1 @@
+module.exports = require('./dist/auth');

bin.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('./dist/bin');

components/elements.js

@@ -0,0 +1,5 @@
+exports.Button = require('../dist/admin/components/elements/Button').default;
+exports.Card = require('../dist/admin/components/elements/Card').default;
+exports.Eyebrow = require('../dist/admin/components/elements/Eyebrow').default;
+exports.Nav = require('../dist/admin/components/elements/Nav').default;
+exports.Gutter = require('../dist/admin/components/elements/Gutter').Gutter;

components/elements.ts

@@ -0,0 +1,5 @@
+export { default as Button } from '../dist/admin/components/elements/Button';
+export { default as Card } from '../dist/admin/components/elements/Card';
+export { default as Eyebrow } from '../dist/admin/components/elements/Eyebrow';
+export { default as Nav } from '../dist/admin/components/elements/Nav';
+export { Gutter } from '../dist/admin/components/elements/Gutter';

components/fields/Array.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Array/types';

components/fields/Blocks.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Blocks/types';

components/fields/Cell.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/views/collections/List/Cell/types';

components/fields/Checkbox.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Checkbox/types';

components/fields/Code.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Code/types';

components/fields/DateTime.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/DateTime/types';

components/fields/Email.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Email/types';

components/fields/Group.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Group/types';

components/fields/Json.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/JSON/types';

components/fields/Number.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Number/types';

components/fields/Password.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Password/types';

components/fields/RadioGroup/RadioInput.ts

@@ -0,0 +1 @@
+export type { Props } from '../../../dist/admin/components/forms/field-types/RadioGroup/RadioInput/types';

components/fields/RadioGroup/index.ts

@@ -0,0 +1 @@
+export type { Props } from '../../../dist/admin/components/forms/field-types/RadioGroup/types';

components/fields/Relationship.ts

@@ -0,0 +1 @@
+export type { Props, Option, ValueWithRelation } from '../../dist/admin/components/forms/field-types/Relationship/types';

components/fields/RichText.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/RichText/types';

components/fields/Row.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Row/types';

components/fields/Select.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Select/types';

components/fields/Text.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Text/types';

components/fields/Textarea.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Textarea/types';

components/fields/Upload.ts

@@ -0,0 +1 @@
+export type { Props } from '../../dist/admin/components/forms/field-types/Upload/types';

components/forms.js

@@ -0,0 +1,42 @@
+exports.useForm = require('../dist/admin/components/forms/Form/context').useForm;
+
+/**
+ * @deprecated useWatchForm is no longer preferred. If you need all form fields, prefer `useAllFormFields`.
+ */
+exports.useWatchForm = require('../dist/admin/components/forms/Form/context').useWatchForm;
+
+exports.useFormFields = require('../dist/admin/components/forms/Form/context').useFormFields;
+
+exports.useAllFormFields = require('../dist/admin/components/forms/Form/context').useAllFormFields;
+
+exports.useFormSubmitted = require('../dist/admin/components/forms/Form/context').useFormSubmitted;
+
+exports.useFormProcessing = require('../dist/admin/components/forms/Form/context').useFormProcessing;
+
+exports.useFormModified = require('../dist/admin/components/forms/Form/context').useFormModified;
+
+exports.useField = require('../dist/admin/components/forms/useField').default;
+
+/**
+ * @deprecated This method is now called useField. The useFieldType alias will be removed in an upcoming version.
+ */
+exports.useFieldType = require('../dist/admin/components/forms/useField').default;
+
+exports.Form = require('../dist/admin/components/forms/Form').default;
+
+exports.Text = require('../dist/admin/components/forms/field-types/Text').default;
+exports.TextInput = require('../dist/admin/components/forms/field-types/Text/Input').default;
+
+exports.Group = require('../dist/admin/components/forms/field-types/Group').default;
+
+exports.Select = require('../dist/admin/components/forms/field-types/Select').default;
+exports.SelectInput = require('../dist/admin/components/forms/field-types/Select/Input').default;
+
+exports.Checkbox = require('../dist/admin/components/forms/field-types/Checkbox').default;
+exports.Submit = require('../dist/admin/components/forms/Submit').default;
+exports.Label = require('../dist/admin/components/forms/Label').default;
+
+exports.reduceFieldsToValues = require('../dist/admin/components/forms/Form/reduceFieldsToValues').default;
+exports.getSiblingData = require('../dist/admin/components/forms/Form/getSiblingData').default;
+
+exports.withCondition = require('../dist/admin/components/forms/withCondition').default;

components/forms.ts

@@ -0,0 +1,38 @@
+export {
+  useForm,
+  /**
+   * @deprecated useWatchForm is no longer preferred. If you need all form fields, prefer `useAllFormFields`.
+   */
+  useWatchForm,
+  useFormFields,
+  useAllFormFields,
+  useFormSubmitted,
+  useFormProcessing,
+  useFormModified,
+} from '../dist/admin/components/forms/Form/context';
+
+export { default as useField } from '../dist/admin/components/forms/useField';
+
+/**
+ * @deprecated This method is now called useField. The useFieldType alias will be removed in an upcoming version.
+ */
+export { default as useFieldType } from '../dist/admin/components/forms/useField';
+
+export { default as Form } from '../dist/admin/components/forms/Form';
+
+export { default as Text } from '../dist/admin/components/forms/field-types/Text';
+export { default as TextInput } from '../dist/admin/components/forms/field-types/Text/Input';
+
+export { default as Group } from '../dist/admin/components/forms/field-types/Group';
+
+export { default as Select } from '../dist/admin/components/forms/field-types/Select';
+export { default as SelectInput } from '../dist/admin/components/forms/field-types/Select/Input';
+
+export { default as Checkbox } from '../dist/admin/components/forms/field-types/Checkbox';
+export { default as Submit } from '../dist/admin/components/forms/Submit';
+export { default as Label } from '../dist/admin/components/forms/Label';
+
+export { default as reduceFieldsToValues } from '../dist/admin/components/forms/Form/reduceFieldsToValues';
+export { default as getSiblingData } from '../dist/admin/components/forms/Form/getSiblingData';
+
+export { default as withCondition } from '../dist/admin/components/forms/withCondition';

components/hooks.js

@@ -0,0 +1 @@
+exports.useStepNav = require('../dist/admin/components/elements/StepNav').useStepNav;

components/hooks.ts

@@ -0,0 +1 @@
+export { useStepNav } from '../dist/admin/components/elements/StepNav';

components/icons.js

@@ -0,0 +1,2 @@
+exports.Chevron = require('../dist/admin/components/icons/Chevron').default;
+exports.X = require('../dist/admin/components/icons/X').default;

components/icons.ts

@@ -0,0 +1,2 @@
+export { default as Chevron } from '../dist/admin/components/icons/Chevron';
+export { default as X } from '../dist/admin/components/icons/X';

components/index.ts

@@ -0,0 +1 @@
+export * from '../dist/admin/components';

components/preferences.js

@@ -0,0 +1 @@
+exports.usePreferences = require('../dist/admin/components/utilities/Preferences').usePreferences;

components/preferences.ts

@@ -0,0 +1 @@
+export { usePreferences } from '../dist/admin/components/utilities/Preferences';

components/rich-text.js

@@ -0,0 +1,3 @@
+exports.LeafButton = require('../dist/admin/components/forms/field-types/RichText/leaves/Button').default;
+exports.ElementButton = require('../dist/admin/components/forms/field-types/RichText/elements/Button').default;
+exports.toggleElement = require('../dist/admin/components/forms/field-types/RichText/elements/toggle').default;

components/rich-text.ts

@@ -0,0 +1,3 @@
+export { default as LeafButton } from '../dist/admin/components/forms/field-types/RichText/leaves/Button';
+export { default as ElementButton } from '../dist/admin/components/forms/field-types/RichText/elements/Button';
+export { default as toggleElement } from '../dist/admin/components/forms/field-types/RichText/elements/toggle';

components/templates.js

@@ -0,0 +1,2 @@
+exports.DefaultTemplate = require('../dist/admin/components/templates/Default').default;
+exports.MinimalTemplate = require('../dist/admin/components/templates/Minimal').default;

components/templates.ts

@@ -0,0 +1,2 @@
+export { default as DefaultTemplate } from '../dist/admin/components/templates/Default';
+export { default as MinimalTemplate } from '../dist/admin/components/templates/Minimal';

components/utilities.js

@@ -0,0 +1,7 @@
+exports.Meta = require('../dist/admin/components/utilities/Meta').default;
+exports.useLocale = require('../dist/admin/components/utilities/Locale').useLocale;
+exports.useDocumentInfo = require('../dist/admin/components/utilities/DocumentInfo').useDocumentInfo;
+exports.useConfig = require('../dist/admin/components/utilities/Config').useConfig;
+exports.useAuth = require('../dist/admin/components/utilities/Auth').useAuth;
+exports.useEditDepth = require('../dist/admin/components/utilities/EditDepth').useEditDepth;
+exports.useTheme = require('../dist/admin/components/utilities/Theme').useTheme;

components/utilities.ts

@@ -0,0 +1,6 @@
+export { default as Meta } from '../dist/admin/components/utilities/Meta';
+export { useLocale } from '../dist/admin/components/utilities/Locale';
+export { useDocumentInfo } from '../dist/admin/components/utilities/DocumentInfo';
+export { useConfig } from '../dist/admin/components/utilities/Config';
+export { useAuth } from '../dist/admin/components/utilities/Auth';
+export { useEditDepth } from '../dist/admin/components/utilities/EditDepth';

components/views/Cell.js

@@ -0,0 +1 @@
+exports.Cell = require('../../dist/admin/components/views/collections/List/Cell').default;

components/views/Cell.ts

@@ -0,0 +1,2 @@
+export { default as Cell } from '../../dist/admin/components/views/collections/List/Cell';
+export type { Props } from '../../dist/admin/components/views/collections/List/Cell/types';

components/views/Dashboard.js

@@ -0,0 +1 @@
+exports.Dashboard = required('../../dist/admin/components/views/Dashboard/Default').default;

components/views/Dashboard.ts

@@ -0,0 +1,3 @@
+export { default as Dashboard } from '../../dist/admin/components/views/Dashboard/Default';
+
+export type { Props } from '../../dist/admin/components/views/Dashboard/types';

components/views/Edit.js

@@ -0,0 +1 @@
+exports.Edit = require('../../dist/admin/components/views/collections/Edit/Default').default;

components/views/Edit.ts

@@ -0,0 +1,2 @@
+export { default as Edit } from '../../dist/admin/components/views/collections/Edit/Default';
+export type { Props } from '../../dist/admin/components/views/collections/Edit/types';

components/views/List.js

@@ -0,0 +1 @@
+exports.List = require('../../dist/admin/components/views/collections/List/Default').default;

components/views/List.ts

@@ -0,0 +1,2 @@
+export { default as List } from '../../dist/admin/components/views/collections/List/Default';
+export type { Props } from '../../dist/admin/components/views/collections/Edit/types';

config.d.ts

@@ -0,0 +1,2 @@
+export { buildConfig } from './dist/config/build';
+export * from './dist/config/types';

config.js

@@ -0,0 +1 @@
+exports.buildConfig = require('./dist/config/build').buildConfig;

contributing.md

@@ -0,0 +1,56 @@
+# Contributing to Payload CMS
+
+Below you'll find a set of guidelines for how to contribute to Payload CMS.
+
+## Opening issues
+
+Before you submit an issue, please check all existing [open and closed issues](https://github.com/payloadcms/payload/issues) to see if your issue has previously been resolved or is already known. If there is already an issue logged, feel free to upvote it by adding a :thumbsup: [reaction](https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments). If you would like to submit a new issue, please fill out our Issue Template to the best of your ability so we can accurately understand your report.
+
+## Security issues & vulnerabilities
+
+If you come across an issue related to security, or a potential attack vector within Payload or one of its dependencies, please DO NOT create a publicly viewable issue. Instead, please contact us directly at [`dev@payloadcms.com`](mailto:dev@payloadcms.com). We will do everything we can to respond to the issue as soon as possible.
+
+If you find a vulnerability within the core Payload repository, and we determine that it is remediable and of significant nature, we will be happy to pay you a reward for your findings and diligence. [`Contact us`](mailto:dev@payloadcms.com) to find out more.
+
+## Documentation edits
+
+Payload documentation can be found directly within its codebase and you can feel free to make changes / improvements to any of it through opening a PR. We utilize these files directly in our website and will periodically deploy documentation updates as necessary.
+
+## Building additional features
+
+If you're an incredibly awesome person and want to help us make Payload even better through new features or additions, we would be thrilled to work with you.
+
+### Before Starting
+
+To help us work on new features, you can create a new feature request post in [GitHub Discussion](https://github.com/payloadcms/payload/discussions) or discuss it in our [Discord](https://discord.com/invite/r6sCXqVk3v). New functionality often has large implications across the entire Payload repo, so it is best to discuss the architecture and approach before starting work on a pull request.
+
+### Code
+
+Most new functionality should keep testing in mind. With 1.0, testability of new features has been vastly improved. All top-level directories within the `test/` directory are for testing a specific category: `fields`, `collections`, etc.
+
+If it makes sense to add your feature to an existing test directory, please do so.
+
+A typical directory with `test/` will be structured like this:
+
+```text
+.
+├── config.ts
+├── int.spec.ts
+├── e2e.spec.ts
+└── payload-types.ts
+```
+
+- `config.ts` - This is the _granular_ Payload config for testing. It should be as lightweight as possible. Reference existing configs for an example
+- `int.spec.ts` - This is the test file run by jest. Any test file must have a `*int.spec.ts` suffix.
+- `e2e.spec.ts` - This is the end-to-end test file that will load up the admin UI using the above config and run Playwright tests. These tests are typically only needed if a large change is being made to the Admin UI.
+- `payload-types.ts` - Generated types from `config.ts`. Generate this file by running `yarn dev:generate-types my-test-dir`.
+
+The directory split up in this way specifically to reduce friction when creating tests and to add the ability to boot up Payload with that specific config.
+
+The following command will start Payload with your config: `yarn dev my-test-dir`. This command will start up Payload using your config and refresh a test database on every restart.
+
+NOTE: It is recommended to add the test credentials (located in `test/credentials.ts`) to your autofill for `localhost:3000/admin` as this will be required on every nodemon restart. The default credentials are `dev@payloadcms.com` as E-Mail and `test` as password.
+
+## Pull Requests
+
+For all Pull Requests, you should be extremely descriptive about both your problem and proposed solution. If there are any affected open or closed issues, please leave the issue number in your PR message.

demo/access/checkRole.js

@@ -1,21 +0,0 @@
-/**
- * authorize a request by comparing the current user with one or more roles
- * @param allRoles
- * @param user
- * @returns {Function}
- */
-const checkRole = (allRoles, user) => {
-  if (user) {
-    if (allRoles.some((role) => {
-      return user.roles && user.roles.some((individualRole) => {
-        return individualRole === role;
-      });
-    })) {
-      return true;
-    }
-  }
-
-  return false;
-};
-
-module.exports = checkRole;

demo/access/roles.js

@@ -1,7 +0,0 @@
-module.exports = [
-  'admin',
-  'editor',
-  'moderator',
-  'user',
-  'viewer',
-];

demo/blocks/CallToAction.js

@@ -1,23 +0,0 @@
-module.exports = {
-  slug: 'cta',
-  labels: {
-    singular: 'Call to Action',
-    plural: 'Calls to Action',
-  },
-  fields: [
-    {
-      name: 'label',
-      label: 'Label',
-      type: 'text',
-      maxLength: 100,
-      required: true,
-    },
-    {
-      name: 'url',
-      label: 'URL',
-      type: 'text',
-      height: 100,
-      required: true,
-    },
-  ],
-};

demo/blocks/Email.js

@@ -1,16 +0,0 @@
-module.exports = {
-  slug: 'email',
-  labels: {
-    singular: 'Email',
-    plural: 'Emails',
-  },
-  fields: [
-    {
-      name: 'testEmail',
-      label: 'Test Email Field',
-      type: 'email',
-      maxLength: 100,
-      required: true,
-    },
-  ],
-};

demo/blocks/Number.js

@@ -1,16 +0,0 @@
-module.exports = {
-  slug: 'number',
-  labels: {
-    singular: 'Number',
-    plural: 'Numbers',
-  },
-  fields: [
-    {
-      name: 'testNumber',
-      label: 'Test Number Field',
-      type: 'number',
-      maxLength: 100,
-      required: true,
-    },
-  ],
-};

demo/blocks/Quote.js

@@ -1,31 +0,0 @@
-module.exports = {
-  blockImage: '/static/assets/images/generic-block-image.svg',
-  slug: 'quote',
-  labels: {
-    singular: 'Quote',
-    plural: 'Quotes',
-  },
-  fields: [
-    {
-      name: 'author',
-      label: 'Author',
-      type: 'relationship',
-      relationTo: 'public-users',
-      required: true,
-    },
-    {
-      name: 'quote',
-      label: 'Quote',
-      type: 'textarea',
-      height: 100,
-      required: true,
-    },
-    {
-      name: 'color',
-      label: 'Color',
-      type: 'text',
-      maxLength: 7,
-      required: true,
-    },
-  ],
-};

demo/client/components.js

@@ -1,9 +0,0 @@
-import PageList from '../collections/Page/components/List';
-
-const components = {
-  pages: {
-    List: PageList,
-  },
-};
-
-export default components;

demo/client/components/layout/Sidebar/index.js

@@ -1,5 +0,0 @@
-import React from 'react';
-
-const Sidebar = () => <div className="sidebar">fake sidebar</div>
-
-export default Sidebar;

demo/collections/Admin.js

@@ -1,61 +0,0 @@
-const roles = require('../access/roles');
-const checkRole = require('../access/checkRole');
-
-const access = ({ req: { user } }) => {
-  const result = checkRole(['admin'], user);
-  return result;
-};
-
-module.exports = {
-  slug: 'admins',
-  labels: {
-    singular: 'Admin',
-    plural: 'Admins',
-  },
-  access: {
-    create: access,
-    read: access,
-    update: access,
-    delete: access,
-    admin: () => true,
-  },
-  auth: {
-    tokenExpiration: 7200,
-    useAPIKey: true,
-    secureCookie: process.env.NODE_ENV === 'production',
-  },
-  fields: [
-    {
-      name: 'roles',
-      label: 'Role',
-      type: 'select',
-      options: roles,
-      defaultValue: 'user',
-      required: true,
-      saveToJWT: true,
-      hasMany: true,
-    },
-    {
-      name: 'apiKey',
-      access: {
-        read: ({ req: { user } }) => {
-          if (checkRole(['admin'], user)) {
-            return true;
-          }
-
-          if (user) {
-            return {
-              email: user.email,
-            };
-          }
-
-          return false;
-        },
-      },
-    },
-  ],
-  timestamps: true,
-  admin: {
-    useAsTitle: 'email',
-  },
-};

demo/collections/AllFields.js

@@ -1,233 +0,0 @@
-const checkRole = require('../access/checkRole');
-const Email = require('../blocks/Email');
-const Quote = require('../blocks/Quote');
-const NumberBlock = require('../blocks/Number');
-const CallToAction = require('../blocks/CallToAction');
-
-const AllFields = {
-  slug: 'all-fields',
-  labels: {
-    singular: 'All Fields',
-    plural: 'All Fields',
-  },
-  admin: {
-    useAsTitle: 'text',
-  },
-  preview: (doc, token) => {
-    if (doc && doc.text) {
-      return `http://localhost:3000/previewable-posts/${doc.text.value}?preview=true&token=${token}`;
-    }
-
-    return null;
-  },
-  access: {
-    read: () => true,
-  },
-  fields: [
-    {
-      name: 'text',
-      type: 'text',
-      label: 'Text',
-      required: true,
-      defaultValue: 'Default Value',
-      unique: true,
-      access: {
-        create: ({ req: { user } }) => checkRole(['admin'], user),
-        update: ({ req: { user } }) => checkRole(['admin'], user),
-        read: ({ req: { user } }) => Boolean(user),
-      },
-    },
-    {
-      name: 'image',
-      type: 'upload',
-      label: 'Image',
-      relationTo: 'media',
-    },
-    {
-      name: 'select',
-      label: 'Select',
-      type: 'select',
-      options: [{
-        value: 'option-1',
-        label: 'Option 1 Label',
-      }, {
-        value: 'option-2',
-        label: 'Option 2 Label',
-      }, {
-        value: 'option-3',
-        label: 'Option 3 Label',
-      }, {
-        value: 'option-4',
-        label: 'Option 4 Label',
-      }],
-      defaultValue: 'option-1',
-      required: true,
-    },
-    {
-      name: 'selectMany',
-      label: 'Select w/ hasMany',
-      type: 'select',
-      options: [{
-        value: 'option-1',
-        label: 'Option 1 Label',
-      }, {
-        value: 'option-2',
-        label: 'Option 2 Label',
-      }, {
-        value: 'option-3',
-        label: 'Option 3 Label',
-      }, {
-        value: 'option-4',
-        label: 'Option 4 Label',
-      }],
-      defaultValue: 'option-1',
-      required: true,
-      hasMany: true,
-    },
-    {
-      name: 'radioGroupExample',
-      label: 'Radio Group Example',
-      type: 'radio',
-      options: [{
-        value: 'option-1',
-        label: 'Options 1 Label',
-      }, {
-        value: 'option-2',
-        label: 'Option 2 Label',
-      }, {
-        value: 'option-3',
-        label: 'Option 3 Label',
-      }],
-      defaultValue: 'option-2',
-      required: true,
-    },
-    {
-      type: 'row',
-      fields: [
-        {
-          name: 'email',
-          label: 'Email',
-          type: 'email',
-        }, {
-          name: 'number',
-          label: 'Number',
-          type: 'number',
-        },
-      ],
-    },
-    {
-      type: 'group',
-      label: 'Group',
-      name: 'group',
-      fields: [
-        {
-          type: 'row',
-          fields: [
-            {
-              name: 'nestedText1',
-              label: 'Nested Text 1',
-              type: 'text',
-            }, {
-              name: 'nestedText2',
-              label: 'Nested Text 2',
-              type: 'text',
-            },
-          ],
-        },
-      ],
-    },
-    {
-      type: 'array',
-      label: 'Array',
-      name: 'array',
-      minRows: 2,
-      maxRows: 4,
-      fields: [
-        {
-          type: 'row',
-          fields: [
-            {
-              name: 'arrayText1',
-              label: 'Array Text 1',
-              type: 'text',
-              required: true,
-            }, {
-              name: 'arrayText2',
-              label: 'Array Text 2',
-              type: 'text',
-              required: true,
-              access: {
-                read: ({ req: { user } }) => Boolean(user),
-                update: ({ req: { user } }) => checkRole(['admin'], user),
-              },
-            },
-          ],
-        },
-        {
-          type: 'text',
-          name: 'arrayText3',
-          label: 'Array Text 3',
-          admin: {
-            readOnly: true,
-          },
-        },
-      ],
-    },
-    {
-      type: 'blocks',
-      label: 'Blocks Content',
-      name: 'blocks',
-      minRows: 2,
-      singularLabel: 'Block',
-      blocks: [Email, NumberBlock, Quote, CallToAction],
-      localized: true,
-      required: true,
-    },
-    {
-      type: 'relationship',
-      label: 'Relationship to One Collection',
-      name: 'relationship',
-      relationTo: 'conditions',
-    },
-    {
-      type: 'relationship',
-      label: 'Relationship hasMany',
-      name: 'relationshipHasMany',
-      relationTo: 'localized-posts',
-      hasMany: true,
-    },
-    {
-      type: 'relationship',
-      label: 'Relationship to Multiple Collections',
-      name: 'relationshipMultipleCollections',
-      relationTo: ['localized-posts', 'conditions'],
-    },
-    {
-      type: 'textarea',
-      label: 'Textarea',
-      name: 'textarea',
-    },
-    {
-      name: 'slug',
-      type: 'text',
-      label: 'Slug',
-      admin: {
-        position: 'sidebar',
-      },
-      localized: true,
-      unique: true,
-      required: true,
-    },
-    {
-      name: 'checkbox',
-      type: 'checkbox',
-      label: 'Checkbox',
-      admin: {
-        position: 'sidebar',
-      },
-    },
-  ],
-  timestamps: true,
-};
-
-module.exports = AllFields;

demo/collections/Blocks.js

@@ -1,26 +0,0 @@
-const Email = require('../blocks/Email');
-const Quote = require('../blocks/Quote');
-const NumberBlock = require('../blocks/Number');
-const CallToAction = require('../blocks/CallToAction');
-
-module.exports = {
-  slug: 'blocks',
-  labels: {
-    singular: 'Blocks',
-    plural: 'Blocks',
-  },
-  access: {
-    read: () => true,
-  },
-  fields: [
-    {
-      name: 'layout',
-      label: 'Layout Blocks',
-      singularLabel: 'Block',
-      type: 'blocks',
-      blocks: [Email, NumberBlock, Quote, CallToAction],
-      localized: true,
-      required: true,
-    },
-  ],
-};

demo/collections/Code.js

@@ -1,17 +0,0 @@
-const Code = {
-  slug: 'code',
-  labels: {
-    singular: 'Code',
-    plural: 'Codes',
-  },
-  fields: [
-    {
-      name: 'code',
-      type: 'code',
-      label: 'Code',
-      required: true,
-    },
-  ],
-};
-
-module.exports = Code;

demo/collections/Conditions.js

@@ -1,53 +0,0 @@
-const Conditions = {
-  slug: 'conditions',
-  labels: {
-    singular: 'Conditions',
-    plural: 'Conditions',
-  },
-  fields: [
-    {
-      name: 'title',
-      type: 'text',
-      label: 'Title',
-      required: true,
-    },
-    {
-      name: 'enableTest',
-      type: 'checkbox',
-      label: 'Enable Test',
-    },
-    {
-      name: 'number',
-      type: 'number',
-      label: 'Number Field',
-    },
-    {
-      name: 'simpleCondition',
-      type: 'text',
-      label: 'Enable Test is checked',
-      required: true,
-      admin: {
-        condition: (_, siblings) => siblings.enableTest === true,
-      },
-    },
-    {
-      name: 'orCondition',
-      type: 'text',
-      label: 'Number is greater than 20 OR enableTest is checked',
-      required: true,
-      admin: {
-        condition: (_, siblings) => siblings.number > 20 || siblings.enableTest === true,
-      },
-    },
-    {
-      name: 'nestedConditions',
-      type: 'text',
-      label: 'Number is either greater than 20 AND enableTest is checked, OR number is less than 20 and enableTest is NOT checked',
-      admin: {
-        condition: (_, siblings) => (siblings.number > 20 && siblings.enableTest === true) || (siblings.number < 20 && siblings.enableTest === false),
-      },
-    },
-  ],
-};
-
-module.exports = Conditions;

demo/collections/CustomComponents/components/fields/Description/Cell/index.js

@@ -1,5 +0,0 @@
-import React from 'react';
-
-const Cell = () => <div className="description">fake description cell</div>;
-
-export default Cell;

demo/collections/CustomComponents/components/fields/Description/Field/index.js

@@ -1,5 +0,0 @@
-import React from 'react';
-
-const Description = () => <div className="description">fake description field</div>
-
-export default Description;

demo/collections/CustomComponents/components/fields/Description/Filter/index.js

@@ -1,26 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-
-import './index.scss';
-
-const Filter = ({ onChange, value }) => {
-  return (
-    <input
-      className="custom-description-filter"
-      type="text"
-      onChange={e => onChange(e.target.value)}
-      value={value}
-    />
-  );
-};
-
-Filter.defaultProps = {
-  value: '',
-};
-
-Filter.propTypes = {
-  onChange: PropTypes.func.isRequired,
-  value: PropTypes.string,
-};
-
-export default Filter;

demo/collections/CustomComponents/components/fields/Description/Filter/index.scss

@@ -1,3 +0,0 @@
-.custom-description-filter {
-  background: lightgray;
-}

demo/collections/CustomComponents/components/fields/Group/Field/index.js

@@ -1,21 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import { Group } from '../../../../../../../field-types';
-
-const CustomGroup = (props) => {
-  return (
-    <div className="custom-group">
-      <Group {...props} />
-    </div>
-  );
-};
-
-CustomGroup.defaultProps = {
-  value: '',
-};
-
-CustomGroup.propTypes = {
-  value: PropTypes.string,
-};
-
-export default CustomGroup;

demo/collections/CustomComponents/components/fields/NestedArrayCustomField/Field/index.js

@@ -1,5 +0,0 @@
-import React from 'react';
-
-const NestedArrayCustomField = () => <div className="nested-array-custom-field">Nested array custom field</div>;
-
-export default NestedArrayCustomField;

demo/collections/CustomComponents/components/fields/NestedGroupCustomField/Field/index.js

@@ -1,5 +0,0 @@
-import React from 'react';
-
-const NestedGroupCustomField = () => <div className="nested-group-custom-field">Nested group custom field</div>;
-
-export default NestedGroupCustomField;

demo/collections/CustomComponents/components/fields/NestedText1/Field/index.js

@@ -1,5 +0,0 @@
-import React from 'react';
-
-const NestedText1 = () => <div className="nested-text-1">Nested Text 1</div>;
-
-export default NestedText1;

demo/collections/CustomComponents/components/views/List/index.js

@@ -1,25 +0,0 @@
-import React from 'react';
-import PropTypes from 'prop-types';
-import DefaultList from '../../../../../../src/client/components/views/collections/List/Default';
-
-import './index.scss';
-
-const CustomListView = (props) => {
-  return (
-    <div className="custom-list">
-      <p>This is a custom Pages list view</p>
-      <p>Sup</p>
-      <DefaultList {...props} />
-    </div>
-  );
-};
-
-CustomListView.propTypes = {
-  collection: PropTypes.shape({
-    labels: PropTypes.shape({
-      plural: PropTypes.string,
-    }),
-  }).isRequired,
-};
-
-export default CustomListView;

demo/collections/CustomComponents/components/views/List/index.scss

@@ -1,5 +0,0 @@
-$color: purple;
-
-.custom-list {
-  color: $color;
-}

demo/collections/CustomComponents/index.js

@@ -1,102 +0,0 @@
-const path = require('path');
-
-module.exports = {
-  slug: 'custom-components',
-  labels: {
-    singular: 'Custom Component',
-    plural: 'Custom Components',
-  },
-  fields: [
-    {
-      name: 'title',
-      label: 'Title',
-      type: 'text',
-      maxLength: 100,
-      required: true,
-      unique: true,
-      localized: true,
-    },
-    {
-      name: 'description',
-      label: 'Description',
-      type: 'textarea',
-      height: 100,
-      required: true,
-      localized: true,
-      admin: {
-        components: {
-          field: path.resolve(__dirname, 'components/fields/Description/Field/index.js'),
-          cell: path.resolve(__dirname, 'components/fields/Description/Cell/index.js'),
-          filter: path.resolve(__dirname, 'components/fields/Description/Filter/index.js'),
-        },
-      },
-    },
-    {
-      name: 'array',
-      label: 'Array',
-      type: 'array',
-      fields: [
-        {
-          type: 'text',
-          name: 'nestedArrayCustomField',
-          label: 'Nested Array Custom Field',
-          admin: {
-            components: {
-              field: path.resolve(__dirname, 'components/fields/NestedArrayCustomField/Field/index.js'),
-            },
-          },
-        },
-      ],
-    },
-    {
-      name: 'group',
-      label: 'Group',
-      type: 'group',
-      admin: {
-        components: {
-          field: path.resolve(__dirname, 'components/fields/Group/Field/index.js'),
-        },
-      },
-      fields: [
-        {
-          type: 'text',
-          name: 'nestedGroupCustomField',
-          label: 'Nested Group Custom Field',
-          admin: {
-            components: {
-              field: path.resolve(__dirname, 'components/fields/NestedGroupCustomField/Field/index.js'),
-            },
-          },
-        },
-      ],
-    },
-    {
-      type: 'row',
-      fields: [
-        {
-          name: 'nestedText1',
-          label: 'Nested Text 1',
-          type: 'text',
-          admin: {
-            components: {
-              field: path.resolve(__dirname, 'components/fields/NestedText1/Field/index.js'),
-            },
-          },
-        }, {
-          name: 'nestedText2',
-          label: 'Nested Text 2',
-          type: 'text',
-        },
-      ],
-    },
-  ],
-  timestamps: true,
-  admin: {
-    useAsTitle: 'title',
-    components: {
-      views: {
-        List: path.resolve(__dirname, 'components/views/List/index.js'),
-      },
-    },
-  },
-};

demo/collections/File.js

@@ -1,66 +0,0 @@
-const path = require('path');
-const checkRole = require('../access/checkRole');
-
-const access = ({ req: { user } }) => {
-  const isAdmin = checkRole(['admin'], user);
-
-  if (isAdmin) {
-    return true;
-  }
-
-  if (user) {
-    return {
-      owner: {
-        equals: user.id,
-      },
-    };
-  }
-};
-
-module.exports = {
-  slug: 'files',
-  labels: {
-    singular: 'File',
-    plural: 'Files',
-  },
-  upload: {
-    staticURL: '/files',
-    staticDir: path.resolve(__dirname, '../files'),
-  },
-  access: {
-    create: () => true,
-    read: access,
-    update: access,
-    delete: access,
-  },
-  fields: [
-    {
-      name: 'type',
-      label: 'Type',
-      type: 'select',
-      options: [{
-        value: 'Type 1',
-        label: 'Type 1 Label',
-      }, {
-        value: 'Type 2',
-        label: 'Type 2 Label',
-      }, {
-        value: 'Type 3',
-        label: 'Type 3 Label',
-      }],
-      defaultValue: 'Type 1',
-      required: true,
-    },
-    {
-      name: 'owner',
-      label: 'Owner',
-      type: 'relationship',
-      relationTo: 'admins',
-      required: true,
-    },
-  ],
-  timestamps: true,
-  admin: {
-    useAsTitle: 'filename',
-  },
-};

demo/collections/HiddenFields.js

@@ -1,31 +0,0 @@
-const HiddenFields = {
-  slug: 'hidden-fields',
-  labels: {
-    singular: 'Hidden Fields',
-    plural: 'Hidden Fields',
-  },
-  fields: [
-    {
-      name: 'title',
-      type: 'text',
-      label: 'Title - Not Hidden',
-      required: true,
-    },
-    {
-      name: 'hiddenAdmin',
-      type: 'text',
-      label: 'Hidden on Admin',
-      hidden: 'admin',
-      required: true,
-    },
-    {
-      name: 'hiddenAPI',
-      type: 'text',
-      label: 'Hidden on API',
-      hidden: true,
-      required: true, // this should not matter
-    },
-  ],
-};
-
-module.exports = HiddenFields;

demo/collections/Hooks.js

@@ -1,91 +0,0 @@
-/* eslint-disable no-param-reassign */
-module.exports = {
-  slug: 'hooks',
-  labels: {
-    singular: 'Hook',
-    plural: 'Hooks',
-  },
-  admin: {
-    useAsTitle: 'title',
-  },
-  access: {
-    create: () => true,
-    read: () => true,
-    update: () => true,
-    delete: () => true,
-  },
-  hooks: {
-    beforeRead: [
-      (operation) => {
-        if (operation.req.headers.hook === 'beforeRead') {
-          console.log('before reading Hooks document');
-        }
-      },
-    ],
-    beforeChange: [
-      (operation) => {
-        if (operation.req.headers.hook === 'beforeChange') {
-          operation.req.body.description += '-beforeChangeSuffix';
-        }
-        return operation.data;
-      },
-    ],
-    beforeDelete: [
-      (operation) => {
-        if (operation.req.headers.hook === 'beforeDelete') {
-          // TODO: Find a better hook operation to assert against in tests
-          operation.req.headers.hook = 'afterDelete';
-        }
-      },
-    ],
-    afterRead: [
-      (operation) => {
-        const { doc } = operation;
-        doc.afterReadHook = true;
-
-        return doc;
-      },
-    ],
-    afterChange: [
-      (operation) => {
-        if (operation.req.headers.hook === 'afterChange') {
-          operation.doc.afterChangeHook = true;
-        }
-        return operation.doc;
-      },
-    ],
-    afterDelete: [
-      (operation) => {
-        if (operation.req.headers.hook === 'afterDelete') {
-          operation.doc.afterDeleteHook = true;
-        }
-        return operation.doc;
-      },
-    ],
-  },
-  fields: [
-    {
-      name: 'title',
-      label: 'Title',
-      type: 'text',
-      maxLength: 100,
-      required: true,
-      unique: true,
-      localized: true,
-      hooks: {
-        afterRead: [
-          ({ value }) => (value ? value.toUpperCase() : null),
-        ],
-      },
-    },
-    {
-      name: 'description',
-      label: 'Description',
-      type: 'textarea',
-      height: 100,
-      required: true,
-      localized: true,
-    },
-  ],
-  timestamps: true,
-};

demo/collections/LocalOperations.js

@@ -1,31 +0,0 @@
-const LocalOperations = {
-  slug: 'local-operations',
-  labels: {
-    singular: 'Local Operation',
-    plural: 'Local Operations',
-  },
-  hooks: {
-    afterRead: [
-      async ({ req, doc }) => {
-        const formattedData = { ...doc };
-        const localizedPosts = await req.payload.find({
-          collection: 'localized-posts',
-        });
-
-        formattedData.localizedPosts = localizedPosts;
-
-        return formattedData;
-      },
-    ],
-  },
-  fields: [
-    {
-      name: 'title',
-      type: 'text',
-      label: 'title',
-      required: true,
-    },
-  ],
-};
-
-module.exports = LocalOperations;

demo/collections/Localized.js

@@ -1,52 +0,0 @@
-module.exports = {
-  slug: 'localized-posts',
-  labels: {
-    singular: 'Localized Post',
-    plural: 'Localized Posts',
-  },
-  admin: {
-    useAsTitle: 'title',
-    defaultColumns: [
-      'title',
-      'priority',
-      'createdAt',
-    ],
-  },
-  access: {
-    read: () => true,
-  },
-  preview: (doc, token) => {
-    if (doc && doc.title) {
-      return `http://localhost:3000/posts/${doc.title.value}?preview=true&token=${token}`;
-    }
-
-    return null;
-  },
-  fields: [
-    {
-      name: 'title',
-      label: 'Title',
-      type: 'text',
-      maxLength: 100,
-      required: true,
-      unique: true,
-      localized: true,
-    },
-    {
-      name: 'description',
-      label: 'Description',
-      type: 'textarea',
-      height: 100,
-      required: true,
-      localized: true,
-    },
-    {
-      name: 'priority',
-      label: 'Priority',
-      type: 'number',
-      required: true,
-      localized: true,
-    },
-  ],
-  timestamps: true,
-};

demo/collections/LocalizedArray.js

@@ -1,50 +0,0 @@
-const LocalizedArrays = {
-  slug: 'localized-arrays',
-  labels: {
-    singular: 'Localized Array',
-    plural: 'Localized Arrays',
-  },
-  access: {
-    read: () => true,
-  },
-  fields: [
-    {
-      type: 'array',
-      label: 'Array',
-      name: 'array',
-      localized: true,
-      required: true,
-      minRows: 2,
-      maxRows: 4,
-      fields: [
-        {
-          type: 'row',
-          fields: [
-            {
-              name: 'arrayText1',
-              label: 'Array Text 1',
-              type: 'text',
-              required: true,
-            }, {
-              name: 'arrayText2',
-              label: 'Array Text 2',
-              type: 'text',
-              required: true,
-            },
-          ],
-        },
-        {
-          type: 'text',
-          name: 'arrayText3',
-          label: 'Array Text 3',
-          admin: {
-            readOnly: true,
-          },
-        },
-      ],
-    },
-  ],
-  timestamps: true,
-};
-
-module.exports = LocalizedArrays;

demo/collections/Media.js

@@ -1,66 +0,0 @@
-const path = require('path');
-const checkRole = require('../access/checkRole');
-
-module.exports = {
-  slug: 'media',
-  labels: {
-    singular: 'Media',
-    plural: 'Media',
-  },
-  access: {
-    read: () => true,
-  },
-  upload: {
-    staticURL: '/media',
-    staticDir: path.resolve(__dirname, '../media'),
-    adminThumbnail: 'mobile',
-    imageSizes: [
-      {
-        name: 'tablet',
-        width: 640,
-        height: 480,
-        crop: 'left top',
-      },
-      {
-        name: 'mobile',
-        width: 320,
-        height: 240,
-        crop: 'left top',
-      },
-      {
-        name: 'icon',
-        width: 16,
-        height: 16,
-      },
-    ],
-  },
-  fields: [
-    {
-      name: 'alt',
-      label: 'Alt Text',
-      type: 'text',
-      required: true,
-      localized: true,
-      hooks: {
-        afterRead: [
-          ({ value }) => `${value} alt`,
-        ],
-      },
-    },
-    {
-      name: 'sizes',
-      fields: [
-        {
-          name: 'icon',
-          access: {
-            read: ({ req: { user } }) => {
-              const result = checkRole(['admin'], user);
-              return result;
-            },
-          },
-        },
-      ],
-    },
-  ],
-  timestamps: true,
-};