@beechcms/cms 0.6.0-preview.2 → 0.6.0-preview.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,35 +1,35 @@
1
- /** Post: blog article with rich text, cover image, tags and SEO */
2
- export const POST_SEED: Seed = {
3
- slug: 'posts',
4
- label: 'Post',
5
- labelPlural: 'Posts',
6
- displayNameAlias: 'title',
7
- allowPublicRead: true,
8
- allowDrafts: true,
9
- branches: [
10
- { id: 'pst_01', alias: 'title', label: 'Title', type: 'text', requiredOnCreate: true },
11
- { id: 'pst_02', alias: 'publishedAt', label: 'Published at', type: 'date' },
12
- { id: 'pst_03', alias: 'coverImage', label: 'Cover image', type: 'file', fileOptions: { accept: 'image' } },
13
- { id: 'pst_04', alias: 'excerpt', label: 'Excerpt', type: 'text' },
14
- { id: 'pst_05', alias: 'tags', label: 'Tags', type: 'json', options: ['news', 'tutorial', 'release', 'guide', 'opinion'] },
15
- { id: 'pst_06', alias: 'body', label: 'Body', type: 'richtext' },
16
- { id: 'pst_07', alias: 'metaTitle', label: 'Meta title (SEO)', type: 'text' },
17
- { id: 'pst_08', alias: 'metaDescription', label: 'Meta description (SEO)', type: 'text' },
18
- ],
19
- }
20
-
21
- /** Author: content creator profile with photo and social link */
22
- export const AUTHOR_SEED: Seed = {
23
- slug: 'authors',
24
- label: 'Author',
25
- labelPlural: 'Authors',
26
- displayNameAlias: 'name',
27
- allowPublicRead: true,
28
- branches: [
29
- { id: 'aut_01', alias: 'name', label: 'Name', type: 'text', requiredOnCreate: true },
30
- { id: 'aut_02', alias: 'bio', label: 'Bio', type: 'text' },
31
- { id: 'aut_03', alias: 'photo', label: 'Photo', type: 'file', fileOptions: { accept: 'image' } },
32
- { id: 'aut_04', alias: 'website', label: 'Website URL', type: 'text' },
33
- { id: 'aut_05', alias: 'active', label: 'Active', type: 'boolean' },
34
- ],
35
- }
1
+ /** Post: blog article with rich text, cover image, tags and SEO */
2
+ export const POST_SEED: Seed = {
3
+ slug: 'posts',
4
+ label: 'Post',
5
+ labelPlural: 'Posts',
6
+ displayNameAlias: 'title',
7
+ allowPublicRead: true,
8
+ allowDrafts: true,
9
+ branches: [
10
+ { id: 'pst_01', alias: 'title', label: 'Title', type: 'text', requiredOnCreate: true },
11
+ { id: 'pst_02', alias: 'publishedAt', label: 'Published at', type: 'date' },
12
+ { id: 'pst_03', alias: 'coverImage', label: 'Cover image', type: 'file', fileOptions: { accept: 'image' } },
13
+ { id: 'pst_04', alias: 'excerpt', label: 'Excerpt', type: 'text' },
14
+ { id: 'pst_05', alias: 'tags', label: 'Tags', type: 'json', options: ['news', 'tutorial', 'release', 'guide', 'opinion'] },
15
+ { id: 'pst_06', alias: 'body', label: 'Body', type: 'richtext' },
16
+ { id: 'pst_07', alias: 'metaTitle', label: 'Meta title (SEO)', type: 'text' },
17
+ { id: 'pst_08', alias: 'metaDescription', label: 'Meta description (SEO)', type: 'text' },
18
+ ],
19
+ }
20
+
21
+ /** Author: content creator profile with photo and social link */
22
+ export const AUTHOR_SEED: Seed = {
23
+ slug: 'authors',
24
+ label: 'Author',
25
+ labelPlural: 'Authors',
26
+ displayNameAlias: 'name',
27
+ allowPublicRead: true,
28
+ branches: [
29
+ { id: 'aut_01', alias: 'name', label: 'Name', type: 'text', requiredOnCreate: true },
30
+ { id: 'aut_02', alias: 'bio', label: 'Bio', type: 'text' },
31
+ { id: 'aut_03', alias: 'photo', label: 'Photo', type: 'file', fileOptions: { accept: 'image' } },
32
+ { id: 'aut_04', alias: 'website', label: 'Website URL', type: 'text' },
33
+ { id: 'aut_05', alias: 'active', label: 'Active', type: 'boolean' },
34
+ ],
35
+ }
@@ -1,29 +1,29 @@
1
- /** Product: e-commerce product catalog with prices, inventory and ratings */
2
- export const PRODUCT_SEED: Seed = {
3
- slug: 'products',
4
- label: 'Product',
5
- labelPlural: 'Products',
6
- displayNameAlias: 'name',
7
- allowPublicRead: true,
8
- branches: [
9
- { alias: 'name', label: 'Product Name', type: 'text', requiredOnCreate: true },
10
- { alias: 'description', label: 'Description', type: 'richtext' },
11
- { alias: 'price', label: 'Price', type: 'number', numberOptions: { format: 'currency', currency: 'EUR', decimals: 2, min: 0, control: 'input', prefix: '€' } },
12
- { alias: 'inventory', label: 'Stock level', type: 'number', numberOptions: { min: 0, step: 1, control: 'stepper' } },
13
- { alias: 'rating', label: 'Rating', type: 'number', numberOptions: { min: 1, max: 5, step: 0.5, control: 'rating' } }
14
- ],
15
- }
16
-
17
- /** Review: product review */
18
- export const REVIEW_SEED: Seed = {
19
- slug: 'reviews',
20
- label: 'Review',
21
- labelPlural: 'Reviews',
22
- displayNameAlias: 'title',
23
- allowPublicRead: true,
24
- branches: [
25
- { alias: 'title', label: 'Review Title', type: 'text', requiredOnCreate: true },
26
- { alias: 'body', label: 'Body', type: 'text' },
27
- { alias: 'score', label: 'Score', type: 'number', numberOptions: { min: 1, max: 5, step: 1, control: 'rating' } }
28
- ],
29
- }
1
+ /** Product: e-commerce product catalog with prices, inventory and ratings */
2
+ export const PRODUCT_SEED: Seed = {
3
+ slug: 'products',
4
+ label: 'Product',
5
+ labelPlural: 'Products',
6
+ displayNameAlias: 'name',
7
+ allowPublicRead: true,
8
+ branches: [
9
+ { alias: 'name', label: 'Product Name', type: 'text', requiredOnCreate: true },
10
+ { alias: 'description', label: 'Description', type: 'richtext' },
11
+ { alias: 'price', label: 'Price', type: 'number', numberOptions: { format: 'currency', currency: 'EUR', decimals: 2, min: 0, control: 'input', prefix: '€' } },
12
+ { alias: 'inventory', label: 'Stock level', type: 'number', numberOptions: { min: 0, step: 1, control: 'stepper' } },
13
+ { alias: 'rating', label: 'Rating', type: 'number', numberOptions: { min: 1, max: 5, step: 0.5, control: 'rating' } }
14
+ ],
15
+ }
16
+
17
+ /** Review: product review */
18
+ export const REVIEW_SEED: Seed = {
19
+ slug: 'reviews',
20
+ label: 'Review',
21
+ labelPlural: 'Reviews',
22
+ displayNameAlias: 'title',
23
+ allowPublicRead: true,
24
+ branches: [
25
+ { alias: 'title', label: 'Review Title', type: 'text', requiredOnCreate: true },
26
+ { alias: 'body', label: 'Body', type: 'text' },
27
+ { alias: 'score', label: 'Score', type: 'number', numberOptions: { min: 1, max: 5, step: 1, control: 'rating' } }
28
+ ],
29
+ }
@@ -1,23 +1,23 @@
1
- /**
2
- * Message: public contact form submission.
3
- *
4
- * allowPublicPost: true — the Public API accepts POST requests without authentication,
5
- * so any frontend form can submit directly to this seed.
6
- * email visibility:masked — the email is stored in full but returned partially
7
- * redacted in API responses (e.g. "jo**@example.com").
8
- * email public:false — the email is never exposed through the Public API.
9
- */
10
- export const MESSAGE_SEED: Seed = {
11
- slug: 'messages',
12
- label: 'Message',
13
- labelPlural: 'Messages',
14
- displayNameAlias: 'name',
15
- allowPublicPost: true,
16
- branches: [
17
- { id: 'msg_01', alias: 'name', label: 'Name', type: 'text', requiredOnCreate: true },
18
- { id: 'msg_02', alias: 'email', label: 'Email', type: 'text', requiredOnCreate: true, policies: { visibility: 'masked', public: false } },
19
- { id: 'msg_03', alias: 'subject', label: 'Subject', type: 'text', requiredOnCreate: true },
20
- { id: 'msg_04', alias: 'message', label: 'Message', type: 'richtext', requiredOnCreate: true },
21
- { id: 'msg_05', alias: 'read', label: 'Read', type: 'boolean' },
22
- ],
23
- }
1
+ /**
2
+ * Message: public contact form submission.
3
+ *
4
+ * allowPublicPost: true — the Public API accepts POST requests without authentication,
5
+ * so any frontend form can submit directly to this seed.
6
+ * email visibility:masked — the email is stored in full but returned partially
7
+ * redacted in API responses (e.g. "jo**@example.com").
8
+ * email public:false — the email is never exposed through the Public API.
9
+ */
10
+ export const MESSAGE_SEED: Seed = {
11
+ slug: 'messages',
12
+ label: 'Message',
13
+ labelPlural: 'Messages',
14
+ displayNameAlias: 'name',
15
+ allowPublicPost: true,
16
+ branches: [
17
+ { id: 'msg_01', alias: 'name', label: 'Name', type: 'text', requiredOnCreate: true },
18
+ { id: 'msg_02', alias: 'email', label: 'Email', type: 'text', requiredOnCreate: true, policies: { visibility: 'masked', public: false } },
19
+ { id: 'msg_03', alias: 'subject', label: 'Subject', type: 'text', requiredOnCreate: true },
20
+ { id: 'msg_04', alias: 'message', label: 'Message', type: 'richtext', requiredOnCreate: true },
21
+ { id: 'msg_05', alias: 'read', label: 'Read', type: 'boolean' },
22
+ ],
23
+ }
@@ -1,41 +1,41 @@
1
- /**
2
- * Your seeds go here.
3
- *
4
- * A Seed defines a content type: its slug (used in API URLs), its display labels,
5
- * and its branches (fields).
6
- *
7
- * Each Branch has:
8
- * id — immutable database key (e.g. 'abc_01'). Never change this after
9
- * the first migration or stored data will break.
10
- * alias — the name used in API payloads (e.g. 'title'). Safe to rename.
11
- * label — human-readable label shown in the dashboard.
12
- * type — 'text' | 'number' | 'boolean' | 'date' | 'richtext' | 'file' | 'json'
13
- *
14
- * Seed-level flags:
15
- * allowPublicRead — expose entries via the unauthenticated Public API (GET).
16
- * allowPublicPost — accept submissions via the Public API (POST). Useful for forms.
17
- * allowDrafts — enable a pending-draft workflow for this content type.
18
- * displayNameAlias — which branch alias is used as the entry title in the dashboard.
19
- *
20
- * Branch policies (all optional):
21
- * policies.visibility — 'full' (default) | 'masked' | 'hidden'
22
- * policies.public — false to exclude the field from Public API responses
23
- * policies.search — false to exclude the field from full-text search
24
- *
25
- * Example — uncomment and adapt to define your first content type:
26
- *
27
- * export const PROJECT_SEED: Seed = {
28
- * slug: 'projects',
29
- * label: 'Project',
30
- * labelPlural: 'Projects',
31
- * displayNameAlias: 'title',
32
- * allowPublicRead: true,
33
- * branches: [
34
- * { id: 'prj_01', alias: 'title', label: 'Title', type: 'text', requiredOnCreate: true },
35
- * { id: 'prj_02', alias: 'description', label: 'Description', type: 'text' },
36
- * { id: 'prj_03', alias: 'coverImage', label: 'Cover image', type: 'file' },
37
- * { id: 'prj_04', alias: 'tags', label: 'Tags', type: 'json' },
38
- * { id: 'prj_05', alias: 'published', label: 'Published', type: 'boolean' },
39
- * ],
40
- * }
41
- */
1
+ /**
2
+ * Your seeds go here.
3
+ *
4
+ * A Seed defines a content type: its slug (used in API URLs), its display labels,
5
+ * and its branches (fields).
6
+ *
7
+ * Each Branch has:
8
+ * id — immutable database key (e.g. 'abc_01'). Never change this after
9
+ * the first migration or stored data will break.
10
+ * alias — the name used in API payloads (e.g. 'title'). Safe to rename.
11
+ * label — human-readable label shown in the dashboard.
12
+ * type — 'text' | 'number' | 'boolean' | 'date' | 'richtext' | 'file' | 'json'
13
+ *
14
+ * Seed-level flags:
15
+ * allowPublicRead — expose entries via the unauthenticated Public API (GET).
16
+ * allowPublicPost — accept submissions via the Public API (POST). Useful for forms.
17
+ * allowDrafts — enable a pending-draft workflow for this content type.
18
+ * displayNameAlias — which branch alias is used as the entry title in the dashboard.
19
+ *
20
+ * Branch policies (all optional):
21
+ * policies.visibility — 'full' (default) | 'masked' | 'hidden'
22
+ * policies.public — false to exclude the field from Public API responses
23
+ * policies.search — false to exclude the field from full-text search
24
+ *
25
+ * Example — uncomment and adapt to define your first content type:
26
+ *
27
+ * export const PROJECT_SEED: Seed = {
28
+ * slug: 'projects',
29
+ * label: 'Project',
30
+ * labelPlural: 'Projects',
31
+ * displayNameAlias: 'title',
32
+ * allowPublicRead: true,
33
+ * branches: [
34
+ * { id: 'prj_01', alias: 'title', label: 'Title', type: 'text', requiredOnCreate: true },
35
+ * { id: 'prj_02', alias: 'description', label: 'Description', type: 'text' },
36
+ * { id: 'prj_03', alias: 'coverImage', label: 'Cover image', type: 'file' },
37
+ * { id: 'prj_04', alias: 'tags', label: 'Tags', type: 'json' },
38
+ * { id: 'prj_05', alias: 'published', label: 'Published', type: 'boolean' },
39
+ * ],
40
+ * }
41
+ */
@@ -1,16 +1,16 @@
1
- /** Gallery item: image or media asset with title, tags and featured flag */
2
- export const GALLERY_SEED: Seed = {
3
- slug: 'gallery',
4
- label: 'Item',
5
- labelPlural: 'Gallery',
6
- displayNameAlias: 'title',
7
- allowPublicRead: true,
8
- branches: [
9
- { id: 'gal_01', alias: 'title', label: 'Title', type: 'text', requiredOnCreate: true },
10
- { id: 'gal_02', alias: 'description', label: 'Description', type: 'text' },
11
- { id: 'gal_03', alias: 'image', label: 'Image', type: 'file', requiredOnCreate: true, fileOptions: { accept: 'image' } },
12
- { id: 'gal_04', alias: 'tags', label: 'Tags', type: 'json' },
13
- { id: 'gal_05', alias: 'date', label: 'Date', type: 'date' },
14
- { id: 'gal_06', alias: 'featured', label: 'Featured', type: 'boolean' },
15
- ],
16
- }
1
+ /** Gallery item: image or media asset with title, tags and featured flag */
2
+ export const GALLERY_SEED: Seed = {
3
+ slug: 'gallery',
4
+ label: 'Item',
5
+ labelPlural: 'Gallery',
6
+ displayNameAlias: 'title',
7
+ allowPublicRead: true,
8
+ branches: [
9
+ { id: 'gal_01', alias: 'title', label: 'Title', type: 'text', requiredOnCreate: true },
10
+ { id: 'gal_02', alias: 'description', label: 'Description', type: 'text' },
11
+ { id: 'gal_03', alias: 'image', label: 'Image', type: 'file', requiredOnCreate: true, fileOptions: { accept: 'image' } },
12
+ { id: 'gal_04', alias: 'tags', label: 'Tags', type: 'json' },
13
+ { id: 'gal_05', alias: 'date', label: 'Date', type: 'date' },
14
+ { id: 'gal_06', alias: 'featured', label: 'Featured', type: 'boolean' },
15
+ ],
16
+ }
@@ -1,12 +1,12 @@
1
- /** Task: project management tasks with progress slider */
2
- export const TASK_SEED: Seed = {
3
- slug: 'tasks',
4
- label: 'Task',
5
- labelPlural: 'Tasks',
6
- displayNameAlias: 'title',
7
- branches: [
8
- { alias: 'title', label: 'Task Title', type: 'text', requiredOnCreate: true },
9
- { alias: 'taskStatus', label: 'Status', type: 'text', options: ['todo', 'in_progress', 'done'] },
10
- { alias: 'completion', label: 'Completion', type: 'number', numberOptions: { format: 'percentage', min: 0, max: 100, step: 5, control: 'slider' } }
11
- ],
12
- }
1
+ /** Task: project management tasks with progress slider */
2
+ export const TASK_SEED: Seed = {
3
+ slug: 'tasks',
4
+ label: 'Task',
5
+ labelPlural: 'Tasks',
6
+ displayNameAlias: 'title',
7
+ branches: [
8
+ { alias: 'title', label: 'Task Title', type: 'text', requiredOnCreate: true },
9
+ { alias: 'taskStatus', label: 'Status', type: 'text', options: ['todo', 'in_progress', 'done'] },
10
+ { alias: 'completion', label: 'Completion', type: 'number', numberOptions: { format: 'percentage', min: 0, max: 100, step: 5, control: 'slider' } }
11
+ ],
12
+ }
package/package.json CHANGED
@@ -1,7 +1,6 @@
1
1
  {
2
2
  "name": "@beechcms/cms",
3
- "version": "0.6.0-preview.2",
4
- "packageManager": "npm@11.9.0",
3
+ "version": "0.6.0-preview.4",
5
4
  "description": "Edge-Native, Schema-Driven Headless CMS built on Cloudflare Workers, D1, and R2. Features the Botanical Engine for alias-stable field management, a modular widget layer, and a React + Vite admin dashboard.",
6
5
  "keywords": [
7
6
  "cms",
@@ -17,7 +16,7 @@
17
16
  "turborepo"
18
17
  ],
19
18
  "author": "Flavio De Musso",
20
- "license": "SEE LICENSE IN LICENSE",
19
+ "license": "SEE LICENSE IN .github/LICENSE",
21
20
  "homepage": "https://github.com/fdemusso/BeechCMS#readme",
22
21
  "repository": {
23
22
  "type": "git",
@@ -26,11 +25,6 @@
26
25
  "bugs": {
27
26
  "url": "https://github.com/fdemusso/BeechCMS/issues"
28
27
  },
29
- "workspaces": [
30
- "apps/*",
31
- "packages/*",
32
- "examples/*"
33
- ],
34
28
  "files": [
35
29
  "bin/",
36
30
  "README.md"
@@ -42,63 +36,31 @@
42
36
  "beechcms": "bin/create.mjs",
43
37
  "beech": "bin/cli.mjs"
44
38
  },
45
- "scripts": {
46
- "dev": "node scripts/dev.mjs",
47
- "dev:full": "node scripts/dev.mjs",
48
- "dev:plain": "cross-env BEECH_DEV_PLAIN=1 node scripts/dev.mjs",
49
- "dev:tunnel-url": "docker compose logs tunnel 2>&1 | grep -Eo 'https://[a-z0-9-]+\\.trycloudflare\\.com' | tail -n 1",
50
- "dev:logs:mailpit": "docker compose logs -f mailpit",
51
- "dev:logs:sqlite": "docker compose logs -f sqlite-web",
52
- "dev:logs:tunnel": "docker compose logs -f tunnel",
53
- "dev:logs:minio": "docker compose logs -f minio",
54
- "dev:mailpit:reset": "curl -X DELETE http://localhost:8025/api/v1/messages",
55
- "dev:stop": "docker compose stop",
56
- "dev:reset": "docker compose down -v",
57
- "build": "turbo run build",
58
- "test": "turbo run test",
59
- "test:coverage": "turbo run test:coverage",
60
- "test:diff": "node scripts/test-coverage-diff.mjs",
61
- "test:dev-cli": "vitest run --config scripts/dev-cli/vitest.config.ts",
62
- "setup:graph": "node scripts/setup-graph.mjs",
63
- "release": "node scripts/release.mjs",
64
- "release:preview": "node scripts/release.mjs --preview",
65
- "postinstall": "node scripts/check-docker.mjs",
66
- "prepare": "husky",
67
- "doctor": "npx react-doctor@latest"
68
- },
69
39
  "type": "module",
70
40
  "devDependencies": {
41
+ "@eslint/js": "^9.39.1",
71
42
  "@vitest/coverage-v8": "^4.1.0",
72
43
  "cross-env": "^10.1.0",
44
+ "eslint": "^9.39.1",
73
45
  "execa": "^9.6.1",
46
+ "globals": "^16.5.0",
74
47
  "husky": "^9.1.7",
75
48
  "ink": "^6.8.0",
76
49
  "ink-spinner": "^5.0.0",
77
50
  "ink-testing-library": "^4.0.0",
78
51
  "react": "^19.2.7",
79
- "react-dom": "^19.2.7",
80
52
  "react-doctor": "^0.2.16",
53
+ "react-dom": "^19.2.7",
81
54
  "shadcn": "^4.4.0",
82
55
  "strip-ansi": "^7.2.0",
83
56
  "tsx": "^4.22.4",
84
- "turbo": "^2.9.16",
57
+ "turbo": "^2.9.18",
85
58
  "typescript": "^5.9.3",
59
+ "typescript-eslint": "^8.48.0",
86
60
  "vitest": "^4.1.0"
87
61
  },
88
- "overrides": {
89
- "react": "^19.2.7",
90
- "react-dom": "^19.2.7",
91
- "qs": "^6.15.2",
92
- "ws": "^8.21.0",
93
- "miniflare": {
94
- "ws": "^8.21.0"
95
- },
96
- "jsdom": {
97
- "ws": "^8.21.0"
98
- }
99
- },
100
62
  "dependencies": {
101
- "@beechcms/cli": "^0.6.0-preview.2",
63
+ "@beechcms/cli": "^0.6.0-preview.4",
102
64
  "@clack/prompts": "^0.9.1",
103
65
  "picocolors": "^1.1.1"
104
66
  },
@@ -113,5 +75,31 @@
113
75
  "@beechcms/core": {
114
76
  "optional": true
115
77
  }
78
+ },
79
+ "scripts": {
80
+ "dev": "node scripts/dev.mjs",
81
+ "dev:full": "node scripts/dev.mjs",
82
+ "dev:plain": "cross-env BEECH_DEV_PLAIN=1 node scripts/dev.mjs",
83
+ "dev:tunnel-url": "docker compose -f docker/docker-compose.yml logs tunnel 2>&1 | grep -Eo 'https://[a-z0-9-]+\\.trycloudflare\\.com' | tail -n 1",
84
+ "dev:logs:mailpit": "docker compose -f docker/docker-compose.yml logs -f mailpit",
85
+ "dev:logs:sqlite": "docker compose -f docker/docker-compose.yml logs -f sqlite-web",
86
+ "dev:logs:tunnel": "docker compose -f docker/docker-compose.yml logs -f tunnel",
87
+ "dev:logs:minio": "docker compose -f docker/docker-compose.yml logs -f minio",
88
+ "dev:mailpit:reset": "curl -X DELETE http://localhost:8025/api/v1/messages",
89
+ "dev:stop": "docker compose -f docker/docker-compose.yml stop",
90
+ "dev:reset": "docker compose -f docker/docker-compose.yml down -v",
91
+ "build": "turbo run build",
92
+ "lint": "turbo run lint",
93
+ "type-check": "turbo run type-check",
94
+ "test": "turbo run test",
95
+ "test:coverage": "turbo run test:coverage",
96
+ "test:diff": "node scripts/test-coverage-diff.mjs",
97
+ "test:dev-cli": "vitest run --config scripts/dev-cli/vitest.config.ts",
98
+ "pipeline": "node scripts/pipeline.mjs",
99
+ "setup:graph": "node scripts/setup-graph.mjs",
100
+ "release": "node scripts/release.mjs",
101
+ "release:preview": "node scripts/release.mjs --preview",
102
+ "postinstall": "node scripts/check-docker.mjs",
103
+ "doctor": "pnpm dlx react-doctor@latest"
116
104
  }
117
- }
105
+ }
package/LICENSE DELETED
@@ -1,40 +0,0 @@
1
- Business Source License 1.1
2
-
3
- License text copyright (c) 2017 MariaDB Corporation Ab, All Rights Reserved.
4
- "Business Source License" is a trademark of MariaDB Corporation Ab.
5
-
6
- Parameters
7
-
8
- Licensor: Flavio De Musso
9
- Licensed Work: BeechCMS
10
- The Licensed Work is (c) 2024–2026 Flavio De Musso
11
- Additional Use Grant: You may make production use of the Licensed Work,
12
- provided that such use does not include offering
13
- a CMS-as-a-Service or content management platform
14
- to third parties where BeechCMS constitutes the
15
- primary functionality of such service.
16
- Change Date: 2030-06-12
17
- Change License: GNU General Public License v2.0 or later
18
-
19
- ---
20
-
21
- For information about alternative licensing arrangements for the
22
- Licensed Work, please contact: demusso1617@gmail.com
23
-
24
- Terms
25
-
26
- The Licensor hereby grants you the right to copy, modify, create derivative works, redistribute, and make non-production use of the Licensed Work. The Licensor may make an Additional Use Grant, above, permitting limited production use.
27
-
28
- Effective on the Change Date, or the fourth anniversary of the first publicly available distribution of a specific version of the Licensed Work under this License, whichever comes first, the Licensor hereby grants you the rights provided under the Change License, and this Business Source License will terminate as to that version of the Licensed Work.
29
-
30
- If your use of the Licensed Work does not comply with the requirements currently in effect as described in this License, you must purchase a commercial license from the Licensor, its affiliated entities, or authorized resellers, or you must refrain from using the Licensed Work.
31
-
32
- All copies of the original and modified Licensed Work, and derivative works of the Licensed Work, are subject to this License. This License applies separately for each version of the Licensed Work and the Change Date may vary for each version of the Licensed Work released by Licensor.
33
-
34
- You must conspicuously display this License on each original or modified copy of the Licensed Work. If you receive the Licensed Work in original or modified form from a third party, the terms and conditions set forth in this License apply to your use of that work.
35
-
36
- Any use of the Licensed Work in violation of this License will automatically terminate your rights under this License for the current and all other versions of the Licensed Work.
37
-
38
- This License does not grant you any right in any trademark or logo of Licensor or its affiliates (provided that you may use a trademark or logo of Licensor as expressly required by this License).
39
-
40
- TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.
package/README.md DELETED
@@ -1,125 +0,0 @@
1
- ![beechLogoDark.png](docs/images/beechLogoDark.png)
2
-
3
- **BeechCMS** is a precision-engineered, solo-developer headless CMS built for developers who deliver high-performance websites for clients with **zero infrastructure overhead**.
4
-
5
- The pitch is simple: you build the site, you hand it over, and your client can manage their own content forever — with **zero hosting costs**. No monthly subscriptions, no server bills, no maintenance contract needed just to keep the lights on.
6
-
7
- This is possible because BeechCMS runs entirely on **Cloudflare's free tier** — Workers for the API, D1 (SQLite at the edge) for the database, and R2 for media storage. A Cloudflare account is all the infrastructure a client ever needs.
8
-
9
- ---
10
-
11
- ## Why Beech?
12
-
13
- ### Zero running costs for your clients
14
-
15
- Cloudflare's free tier covers D1, R2, and Workers for the vast majority of real-world content sites. You deliver a fully self-managed product — dashboard, API, media uploads — and the client pays nothing to keep it running. That's a compelling offer.
16
-
17
- ### Native SQL Performance
18
- Unlike other "flexible" CMSs that store data in slow JSON blobs, Beech generates **dedicated SQL tables** for every content type. Enjoy native B-Tree indexing, `REAL` and `INTEGER` types for mathematical operations, and ultra-fast queries.
19
-
20
- ### Schema-as-Code & Runtime Definitions
21
- Define your content model dynamically via the dashboard UI or in code (TypeScript). The **Botanical Engine** compiles your definitions into deterministic SQL DDL at runtime. Bootstrap your schema from code using `beech onboard` or `beech seed:load`, then let the D1 database act as the single source of truth—with real-time updates and zero server downtime.
22
-
23
- ### Works as a dependency, not a boilerplate
24
-
25
- Your project is four files. The BeechCMS engine, dashboard, and API live inside `node_modules/@beechcms/api`. Update with `npm update @beechcms/api`.
26
-
27
- ---
28
-
29
- ## Getting Started
30
-
31
- ```bash
32
- npx @beechcms/cms
33
- ```
34
-
35
- The interactive wizard scaffolds a ready-to-use project in seconds. For everything from configuration to deployment, see the **[Developer Guide](./docs/guide.md)**.
36
-
37
- ---
38
-
39
- ## The Botanical Engine
40
-
41
- The heart of BeechCMS is the **Botanical Engine**, a high-performance **Schema Compiler** that bridges the gap between TypeScript definitions and SQL infrastructure.
42
-
43
- Instead of generic document storage, the Engine analyzes your **Seeds** (content types) and compiles them into **dedicated SQL tables** within Cloudflare D1. Every field you define becomes a native, type-safe SQL column, allowing for:
44
-
45
- - **Native Performance**: Real B-Tree indices and FTS5 virtual tables for ultra-fast filtering and full-text search.
46
- - **Data Integrity**: Native SQL types (REAL, INTEGER, TEXT) with CHECK constraints for robust data handling.
47
- - **Zero-Manual SQL**: Deterministic DDL generation—defined in code or via the UI, and the Engine handles the database synchronization at runtime.
48
-
49
- ---
50
-
51
- ## Tech Stack
52
-
53
- | Layer | Technology |
54
- |---|---|
55
- | Edge runtime | Cloudflare Workers (V8 Isolates) |
56
- | API framework | Hono v4 |
57
- | Database | Cloudflare D1 (SQLite at the edge) |
58
- | Object storage | Cloudflare R2 (zero egress cost) |
59
- | Shared logic | `@beechcms/core` — Botanical Engine, types, validation |
60
- | Dashboard | React 19 + Vite 7 |
61
- | UI | Tailwind CSS v4 + Shadcn/ui |
62
- | Server state | TanStack Query v5 |
63
- | Rich text | TipTap v3 + KaTeX |
64
- | Auth | `jose` JWT + bcryptjs |
65
- | Validation | Zod v4 |
66
- | Testing | Vitest v3 |
67
- | Build orchestration | Turborepo v2 |
68
-
69
-
70
- ---
71
- ## Documentation
72
-
73
- | Document | Description |
74
- |---|---|
75
- | [Developer Guide](./docs/guide.md) | End-to-end guide: scaffolding, seeds, API consumption, deployment |
76
- | [Architecture](./docs/nuovidocs/architecture.md) | Monorepo topology, Botanical Engine data flow, D1 model |
77
- | [API Reference](./docs/nuovidocs/api-reference.md) | Auth, Content CRUD, Media Engine, Public API, rate limiting |
78
- | [Frontend Guide](./docs/nuovidocs/frontend-guide.md) | FieldRenderer registry, TanStack Query patterns, adding field types |
79
- | [System Map](./docs/SYSTEM_MAP.md) | Folder structure, conventions, and architectural constraints |
80
-
81
- ---
82
- # Faq about BeechCMS
83
- ## Why "Beech"?
84
-
85
- One afternoon I was staring at half a CMS with no name. I'd spent weeks building my desk setup — monitors, peripherals, the works — and the last thing I added was a beech wood desktop. I cut it, shaped it, sanded it, finished it until it was exactly right.
86
-
87
- I was sitting at that desk trying to think of a name, looked to the side, and saw the wood. Beech. And then it clicked — seeds, branches, the forest, the fruit. The whole metaphor was already there in the project: content types are seeds, fields are branches, the data that grows from them is the fruit. The name took about three seconds.
88
-
89
- Sometimes the best names aren't invented. They're found.
90
-
91
- ## Why I Built This
92
-
93
- In 2025 I lost a €2,000 contract for a React showcase site for a construction company. The client needed two things beyond a static site: a blog where they could post photos of new builds, and a contact form. Simple requests — but they turned the project into a problem.
94
-
95
- The tools that existed were either too heavy (WordPress, which the client had already had a bad experience with), too expensive once you added hosting and a managed database, or simply not designed to work alongside a modern React frontend without standing up a dedicated backend. The monthly running costs pushed my quote above what a larger agency — one that already had its own internal tooling — could offer. I lost the contract.
96
-
97
- That was the moment I understood the real gap. Small agencies and freelancers don't lose on talent or quality. They lose because they don't have the same leverage as larger competitors who've already amortized the cost of building their own CMS. I decided to build mine.
98
-
99
- **Why Cloudflare?** I was already looking for an alternative to Vercel that didn't require a paid plan for commercial projects. When I discovered that Cloudflare's free tier included not just Workers but also D1 (a relational database at the edge) and R2 (S3-compatible object storage), the whole architecture became clear. A full CMS backend — API, database, media storage, auth — with zero monthly cost for the client.
100
-
101
- **Why the Botanical Engine?** I built the Botanical Engine as a high-performance **Schema Compiler**. It bridges the gap between the flexibility of a CMS and the power of a relational database. Instead of storing data in generic blobs, it compiles TypeScript definitions into native SQL tables and columns. This ensures rigid data integrity (crucial for things like financial records) and unlocks massive performance gains by leveraging native D1 indexing. This true relational model maintains the simplicity of "Schema-as-Code" while allowing for advanced features like cross-seed relations and complex aggregations.
102
-
103
- **What I learned building it.** BeechCMS is my first serious serverless project. I had no prior experience with Cloudflare Workers, edge computing, or D1. Everything I know about this stack I learned by building this — reading documentation, hitting limits, understanding why they exist, and finding the right abstractions. The project is currently in active development toward a public 1.0 release and is already available on npm.
104
-
105
- ---
106
-
107
- _BeechCMS — Precision-engineered content infrastructure for the edge._
108
-
109
-
110
- ## Licensing
111
-
112
- | Package | License | Details |
113
- |---|---|---|
114
- | `@beechcms/core` | MIT | Free for any use, including commercial |
115
- | `apps/api` | BUSL-1.1 | Free for self-hosting; see Additional Use Grant |
116
- | `apps/dashboard` | BUSL-1.1 | Free for self-hosting; see Additional Use Grant |
117
-
118
- **Self-hosting is always free.**
119
- The BUSL-1.1 only restricts offering BeechCMS as a managed SaaS service
120
- in direct competition with BeechCMS Cloud.
121
- After 2030-05-26, these components convert automatically to GPL v2+.
122
-
123
- For commercial licensing inquiries: demusso1617@gmail.com
124
-
125
- For more detailed information, see our [Licensing Guide](./docs/LICENSING.md).