feat: adds new Cloudflare D1 SQLite adapter, R2 storage adapter and Cloudflare template #12537

r1tsuu · 2025-05-24T13:18:39Z

This feat adds support for

D1 Cloudflare SQLite
R2 storage directly (previously it was via S3 SDK)
Cloudflare 1-click deploy template

Todo checklist:

Fix CI and get all green
Docs for new packages
Comprehensive Readme for template
Final testing of template

Post merge checklist:

Update 1-click URL to /main branch instead
Update deps to stable pinned release instead and generate templates function

michxymi · 2025-06-10T21:54:14Z

Is there any ETA for this? Would love to test a full deployment on Cloudflare with workers and D1 db

PeteJStewart · 2025-06-25T12:20:23Z

What's needed to get this merged? Is there anything I can do to help speed up the process?
Really keen to use this feature!!

kziemski · 2025-07-02T19:02:41Z

@r1tsuu hi took a look at this for a sec and i think your missing something in the setup.
if you want i can complete my pr to push this through
or you can cherry-pick the commit and force push a new a commit missing db-d1-sqlite in the packing

PeteJStewart · 2025-07-22T09:10:53Z

Is there any update on this? Really keen to use this feature. If there's anything such as testing, etc that I could help with to get this live, please say!

…-adapter

github-actions · 2025-07-23T16:26:33Z

📦 esbuild Bundle Analysis for payload

This analysis was generated by esbuild-bundle-analyzer. 🤖

Meta File	Out File	Size (raw)	Note
packages/next/meta_index.json	esbuild/index.js	753.68 KB	🆕 Added
packages/payload/meta_index.json	esbuild/index.js	1.22 MB	🆕 Added
packages/payload/meta_shared.json	esbuild/exports/shared.js	162.09 KB	🆕 Added
packages/richtext-lexical/meta_client.json	esbuild/exports/client_optimized/index.js	263.60 KB	🆕 Added
packages/ui/meta_client.json	esbuild/exports/client_optimized/index.js	1.14 MB	🆕 Added
packages/ui/meta_shared.json	esbuild/exports/shared_optimized/index.js	14.39 KB	🆕 Added

Largest paths

These visualization shows top 20 largest paths in the bundle.

Meta file: packages/next/meta_index.json, Out file: esbuild/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ████████████████████ }}}$ 80.3%, 601.78 KB
dist/views/Version	${{\color{Goldenrod}{ █▋ }}}$ 6.6%, 49.59 KB
dist/views/Document	${{\color{Goldenrod}{ ▌ }}}$ 2.0%, 15.04 KB
dist/views/List	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 10.29 KB
dist/views/Root	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 8.24 KB
dist/views/API	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 5.98 KB
dist/views/Versions	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 5.96 KB
dist/views/Account	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 5.32 KB
dist/elements/DocumentHeader	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 4.81 KB
dist/elements/Nav	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 4.67 KB
dist/views/Login	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 4.39 KB
dist/views/Dashboard	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 3.68 KB
dist/layouts/Root	${{\color{Goldenrod}{ }}}$ 0.4%, 3.11 KB
dist/views/ForgotPassword	${{\color{Goldenrod}{ }}}$ 0.4%, 3.09 KB
dist/templates/Default	${{\color{Goldenrod}{ }}}$ 0.4%, 2.83 KB
dist/views/CreateFirstUser	${{\color{Goldenrod}{ }}}$ 0.4%, 2.76 KB
dist/views/BrowseByFolder	${{\color{Goldenrod}{ }}}$ 0.3%, 2.60 KB
dist/views/CollectionFolders	${{\color{Goldenrod}{ }}}$ 0.3%, 2.46 KB
dist/views/ResetPassword	${{\color{Goldenrod}{ }}}$ 0.3%, 2.41 KB
dist/views/Logout	${{\color{Goldenrod}{ }}}$ 0.3%, 1.91 KB
(other)	${{\color{Goldenrod}{ ████▉ }}}$ 19.7%, 147.22 KB

Meta file: packages/payload/meta_index.json, Out file: esbuild/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ █████████████████▎ }}}$ 69.4%, 841.01 KB
dist/fields/hooks	${{\color{Goldenrod}{ ▉ }}}$ 3.5%, 41.86 KB
dist/collections/operations	${{\color{Goldenrod}{ ▊ }}}$ 3.0%, 36.19 KB
dist/auth/operations	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 15.30 KB
dist/queues/operations	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 12.04 KB
dist/globals/operations	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 11.90 KB
dist/fields/config	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 11.57 KB
dist/utilities/configToJSONSchema.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 11.54 KB
dist/fields/validations.js	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 10.06 KB
dist/bin/generateImportMap	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 8.27 KB
dist/collections/config	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 7.88 KB
dist/database/migrations	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 7.79 KB
dist/uploads/fetchAPI-multipart	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 7.74 KB
dist/index.js	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 7.42 KB
dist/collections/endpoints	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 7.40 KB
dist/config/orderable	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 6.25 KB
dist/auth/strategies	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 5.50 KB
dist/config/sanitize.js	${{\color{Goldenrod}{ }}}$ 0.4%, 5.44 KB
dist/auth/endpoints	${{\color{Goldenrod}{ }}}$ 0.4%, 5.41 KB
dist/utilities/telemetry	${{\color{Goldenrod}{ }}}$ 0.4%, 5.31 KB
(other)	${{\color{Goldenrod}{ ███████▋ }}}$ 30.6%, 370.44 KB

Meta file: packages/payload/meta_shared.json, Out file: esbuild/exports/shared.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ███████████████████▉ }}}$ 79.9%, 126.93 KB
dist/fields/validations.js	${{\color{Goldenrod}{ █▌ }}}$ 6.3%, 10.06 KB
dist/fields/baseFields	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 2.79 KB
dist/utilities/deepCopyObject.js	${{\color{Goldenrod}{ ▍ }}}$ 1.6%, 2.48 KB
dist/auth/cookies.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 1.55 KB
dist/utilities/flattenTopLevelFields.js	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 1.42 KB
dist/fields/config	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 1.28 KB
dist/utilities/flattenAllFields.js	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 943 B
dist/folders/utils	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 916 B
dist/utilities/unflatten.js	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 779 B
dist/utilities/sanitizeUserDataForEmail.js	${{\color{Goldenrod}{ }}}$ 0.4%, 713 B
dist/collections/config	${{\color{Goldenrod}{ }}}$ 0.4%, 570 B
dist/bin/generateImportMap	${{\color{Goldenrod}{ }}}$ 0.4%, 559 B
dist/auth/sessions.js	${{\color{Goldenrod}{ }}}$ 0.3%, 545 B
dist/utilities/getSafeRedirect.js	${{\color{Goldenrod}{ }}}$ 0.3%, 423 B
dist/utilities/deepMerge.js	${{\color{Goldenrod}{ }}}$ 0.3%, 413 B
dist/utilities/getFieldPermissions.js	${{\color{Goldenrod}{ }}}$ 0.2%, 391 B
dist/utilities/formatLabels.js	${{\color{Goldenrod}{ }}}$ 0.2%, 380 B
dist/utilities/appendUploadSelectFields.js	${{\color{Goldenrod}{ }}}$ 0.2%, 360 B
dist/utilities/transformColumnPreferences.js	${{\color{Goldenrod}{ }}}$ 0.2%, 348 B
(other)	${{\color{Goldenrod}{ █████ }}}$ 20.1%, 31.89 KB

Meta file: packages/richtext-lexical/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Path	Size
dist/lexical/plugins	${{\color{Goldenrod}{ ██▉ }}}$ 11.6%, 30.17 KB
dist/features/experimental_table	${{\color{Goldenrod}{ ██▎ }}}$ 9.1%, 23.66 KB
dist/lexical/ui	${{\color{Goldenrod}{ ██▎ }}}$ 9.0%, 23.36 KB
dist/features/blocks	${{\color{Goldenrod}{ ██▏ }}}$ 8.6%, 22.41 KB
dist/packages/@lexical	${{\color{Goldenrod}{ █▊ }}}$ 7.3%, 18.99 KB
dist/features/link	${{\color{Goldenrod}{ █▋ }}}$ 6.9%, 17.96 KB
dist/features/toolbars	${{\color{Goldenrod}{ █▋ }}}$ 6.8%, 17.59 KB
dist/features/upload	${{\color{Goldenrod}{ █▎ }}}$ 5.2%, 13.48 KB
dist/features/textState	${{\color{Goldenrod}{ █ }}}$ 4.2%, 11.02 KB
dist/features/relationship	${{\color{Goldenrod}{ ▉ }}}$ 3.5%, 9.09 KB
dist/lexical/utils	${{\color{Goldenrod}{ ▊ }}}$ 3.1%, 8.08 KB
dist/features/debug	${{\color{Goldenrod}{ ▋ }}}$ 2.8%, 7.39 KB
dist/features/converters	${{\color{Goldenrod}{ ▋ }}}$ 2.7%, 7.04 KB
dist/utilities/fieldsDrawer	${{\color{Goldenrod}{ ▋ }}}$ 2.7%, 7.01 KB
dist/lexical/config	${{\color{Goldenrod}{ ▌ }}}$ 2.0%, 5.10 KB
dist/features/lists	${{\color{Goldenrod}{ ▍ }}}$ 1.9%, 4.95 KB
dist/lexical/theme	${{\color{Goldenrod}{ ▍ }}}$ 1.5%, 4.01 KB
dist/features/format	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 3.46 KB
dist/lexical/LexicalEditor.js	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 3.17 KB
dist/features/indent	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 2.50 KB
(other)	${{\color{Goldenrod}{ ██████████████████████ }}}$ 88.4%, 230.36 KB

Meta file: packages/ui/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ████████████▋ }}}$ 50.6%, 572.93 KB
dist/elements/FolderView	${{\color{Goldenrod}{ ▋ }}}$ 2.6%, 29.14 KB
dist/elements/BulkUpload	${{\color{Goldenrod}{ ▌ }}}$ 2.4%, 26.94 KB
dist/elements/WhereBuilder	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 16.16 KB
dist/views/Edit	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 15.70 KB
dist/fields/Relationship	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 15.39 KB
dist/elements/Table	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 15.29 KB
dist/forms/Form	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 14.96 KB
dist/fields/Blocks	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 12.67 KB
dist/fields/Upload	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 11.50 KB
dist/elements/PublishButton	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 8.72 KB
dist/providers/Folders	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 8.50 KB
dist/elements/LivePreview	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 8.37 KB
dist/elements/QueryPresets	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 8.36 KB
dist/elements/ListHeader	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 7.83 KB
dist/elements/HTMLDiff	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 7.81 KB
dist/fields/Array	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 7.53 KB
dist/views/CollectionFolder	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 7.37 KB
dist/views/List	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 6.96 KB
dist/elements/ReactSelect	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 6.91 KB
(other)	${{\color{Goldenrod}{ ████████████▎ }}}$ 49.4%, 559.71 KB

Meta file: packages/ui/meta_shared.json, Out file: esbuild/exports/shared_optimized/index.js

Path	Size
dist/graphics/Logo	${{\color{Goldenrod}{ █████▋ }}}$ 22.6%, 3.12 KB
../../node_modules	${{\color{Goldenrod}{ ████▊ }}}$ 19.2%, 2.65 KB
dist/graphics/Icon	${{\color{Goldenrod}{ ██▊ }}}$ 11.0%, 1.52 KB
dist/utilities/formatDocTitle	${{\color{Goldenrod}{ ██▍ }}}$ 9.6%, 1.32 KB
dist/providers/TableColumns	${{\color{Goldenrod}{ █▌ }}}$ 6.2%, 862 B
dist/utilities/groupNavItems.js	${{\color{Goldenrod}{ █▍ }}}$ 5.9%, 814 B
dist/utilities/api.js	${{\color{Goldenrod}{ █▍ }}}$ 5.5%, 756 B
dist/elements/Translation	${{\color{Goldenrod}{ ▉ }}}$ 3.6%, 493 B
dist/utilities/handleTakeOver.js	${{\color{Goldenrod}{ ▊ }}}$ 3.2%, 440 B
dist/elements/withMergedProps	${{\color{Goldenrod}{ ▋ }}}$ 2.5%, 339 B
dist/elements/WithServerSideProps	${{\color{Goldenrod}{ ▍ }}}$ 1.7%, 232 B
dist/utilities/handleGoBack.js	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 168 B
dist/fields/mergeFieldStyles.js	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 159 B
dist/forms/Form	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 147 B
dist/utilities/abortAndIgnore.js	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 146 B
dist/utilities/hasSavePermission.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 136 B
dist/utilities/handleBackToDashboard.js	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 129 B
dist/utilities/findLocaleFromCode.js	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 84 B
dist/utilities/sanitizeID.js	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 77 B
dist/utilities/isEditing.js	${{\color{Goldenrod}{ }}}$ 0.4%, 59 B
(other)	${{\color{Goldenrod}{ ███████████████████▎ }}}$ 77.4%, 10.68 KB

Details

Next to the size is how much the size has increased or decreased compared with the base branch of this PR.

‼️: Size increased by 20% or more. Special attention should be given to this.
⚠️: Size increased in acceptable range (lower than 20%).
✅: No change or even downsized.
🗑️: The out file is deleted: not found in base branch.
🆕: The out file is newly found: will be added to base branch.

…-adapter

paulpopus · 2025-07-30T16:33:31Z

For everyone following this thread, thank you for your patience, we just released these adapters under the follow internal/canary versions - mostly for us to test but something anyone can install until we get the template PR rolling

"@payloadcms/db-d1-sqlite": "3.50.0-internal.ca62628",
"@payloadcms/storage-r2": "3.50.0-internal.ca62628",

PeteJStewart · 2025-08-08T11:45:40Z

I'm getting the following issue:

 ⨯ [Error: D1_TYPE_ERROR] {
  payloadInitError: true,
  digest: '2612924677',
  [cause]: [Error: Type 'function' not supported for value 'function() {
    return this[~~(Math.random() * this.length)];
  }']
}

I though this might be because the package is using an old version of drizzle-kit, however, I've patched that, and I'm still getting the same issue.
I'm not sure I'm setting up the config correctly, as there's no documentation on how this works.
Could you perhaps share a basic setup example?
Also, are you experiencing the same issue with the type error?

rodilo · 2025-09-01T10:31:19Z

Did anyone else get the same error? Or has anyone managed to get this working? It would be great to document how to get this working if anyone successfully gets it running!

Did you make it work? If yes, how did you configure this?

ckhicks · 2025-09-12T04:03:16Z

This is the final piece to make Payload a complete no-brainer for Next projects. What needs to happen here to get it over the finish line?

BohdanK-W32 · 2025-09-15T11:48:20Z

Guys, can you update on your plans pls? It seems like the PR stuck for a while and there is no communication from Payload team. Should we expect any progress at least in a month or two? @r1tsuu @paulpopus

paulpopus · 2025-09-15T12:01:12Z

@ckhicks @BohdanK-W32 As soon as the ecommerce plugin is released (very soon) this is our next priority, no timeline right now as a result but we'll get on to this ASAP

…-adapter

DanRibbens

I have a few docs notes to add.

Is it too early to add to add db-d1-sqlite to the int test matrix?

Still looking at other details.

docs/database/sqlite.mdx

docs/upload/storage-adapters.mdx

packages/db-d1-sqlite/README.md

github-actions · 2025-09-30T13:31:12Z

🚀 This is included in version v3.58.0

move sqlite logic to the drizzle package

6652608

github-actions bot added the created-by: Payload team label May 24, 2025

r1tsuu added 9 commits May 24, 2025 16:25

add exports from drizzle

f51c972

fix imports

0829cfb

finish d1 package and fix errors

52f9dca

sqlOnly migrations

da4270f

try testing

9bd5f6f

fix package jason

733594b

fix vercel postgres build

5de2f52

fix postgres build

fd850e7

fix postgres build 2

c3af32e

r1tsuu added 5 commits July 23, 2025 18:59

Merge branch 'main' of github.com:payloadcms/payload into feat/add-d1…

be4f11c

…-adapter

fix type

9ce07c7

fix type

8595b57

Merge branch 'main' of github.com:payloadcms/payload into feat/add-d1…

3d57b06

…-adapter

fix type

65b110e

r1tsuu and others added 7 commits July 25, 2025 15:06

execute method

3f09e27

storage r2

9201051

Merge branch 'main' of github.com:payloadcms/payload into feat/add-d1…

72fbcc3

…-adapter

change version

759bb98

delete :memory

fb19606

add r2 and d1 to publishList in script

f87db1c

empty commit for new hash

ca62628

r1tsuu added 2 commits September 25, 2025 23:34

Merge branch 'main' of github.com:payloadcms/payload into feat/add-d1…

f95bba4

…-adapter

add sqlite to test package json

3291d84

paulpopus changed the title ~~feat: add Cloudflare D1 SQLite database adapter~~ feat: adds new Cloudflare D1 SQLite adapter, R2 storage adapter and Cloudflare template Sep 26, 2025

paulpopus added 11 commits September 26, 2025 16:27

changes to d1 package

df9fce5

remove sqlOnly

8916aea

remove miniflare/d1 dep as its deprecated

b88cbd7

commit lock file

8775d75

update package.json for adapter

224d7a2

add template

618a991

update pack all to dest

642d1a0

update lock file

4154be2

add to setupProd

d2a3f22

remove as any

7dcf69e

add docs and updated readme

bc94fac

paulpopus marked this pull request as ready for review September 29, 2025 19:04

paulpopus requested review from denolfe, AlessioGr and DanRibbens as code owners September 29, 2025 19:04

add link to issue

3ea6ede

DanRibbens requested changes Sep 29, 2025

View reviewed changes

docs/database/sqlite.mdx Show resolved Hide resolved

docs/upload/storage-adapters.mdx Show resolved Hide resolved

DanRibbens reviewed Sep 29, 2025

View reviewed changes

packages/db-d1-sqlite/README.md Outdated Show resolved Hide resolved

update docs with beta warning and readme

91eaf61

DanRibbens approved these changes Sep 29, 2025

View reviewed changes

DanRibbens merged commit 99043ee into main Sep 29, 2025
86 of 89 checks passed

DanRibbens deleted the feat/add-d1-adapter branch September 29, 2025 20:58

feat: adds new Cloudflare D1 SQLite adapter, R2 storage adapter and Cloudflare template #12537

feat: adds new Cloudflare D1 SQLite adapter, R2 storage adapter and Cloudflare template #12537

Conversation

r1tsuu commented May 24, 2025 • edited by paulpopus Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

michxymi commented Jun 10, 2025

Uh oh!

PeteJStewart commented Jun 25, 2025

Uh oh!

kziemski commented Jul 2, 2025

Uh oh!

PeteJStewart commented Jul 22, 2025

Uh oh!

github-actions bot commented Jul 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📦 esbuild Bundle Analysis for payload

Meta file: packages/next/meta_index.json, Out file: esbuild/index.js

Meta file: packages/payload/meta_index.json, Out file: esbuild/index.js

Meta file: packages/payload/meta_shared.json, Out file: esbuild/exports/shared.js

Meta file: packages/richtext-lexical/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Meta file: packages/ui/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Meta file: packages/ui/meta_shared.json, Out file: esbuild/exports/shared_optimized/index.js

Uh oh!

paulpopus commented Jul 30, 2025

Uh oh!

PeteJStewart commented Aug 8, 2025

Uh oh!

rodilo commented Sep 1, 2025

Uh oh!

ckhicks commented Sep 12, 2025

Uh oh!

BohdanK-W32 commented Sep 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

paulpopus commented Sep 15, 2025

Uh oh!

DanRibbens left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Sep 30, 2025

Uh oh!

Uh oh!

r1tsuu commented May 24, 2025 •

edited by paulpopus

Loading

github-actions bot commented Jul 23, 2025 •

edited

Loading

BohdanK-W32 commented Sep 15, 2025 •

edited

Loading