@cloudgrid-io/mcp 0.12.0 → 0.14.0

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.
Files changed (390) hide show
  1. package/package.json +1 -1
  2. package/src/corpus/capability-map.md +82 -2
  3. package/src/corpus/examples/crm/index.md +273 -0
  4. package/src/corpus/examples/kanban/index.md +256 -0
  5. package/src/corpus/templates/_cloudgrid.yaml.reference +228 -0
  6. package/src/corpus/templates/admin-dashboard/README.md +75 -0
  7. package/src/corpus/templates/admin-dashboard/cloudgrid.yaml +233 -0
  8. package/src/corpus/templates/admin-dashboard/index.md +81 -0
  9. package/src/corpus/templates/admin-dashboard/services/web/app/api/orders/route.js +64 -0
  10. package/src/corpus/templates/admin-dashboard/services/web/app/api/users/route.js +63 -0
  11. package/src/corpus/templates/admin-dashboard/services/web/app/layout.js +39 -0
  12. package/src/corpus/templates/admin-dashboard/services/web/app/page.js +73 -0
  13. package/src/corpus/templates/admin-dashboard/services/web/app/resource-table.js +94 -0
  14. package/src/corpus/templates/admin-dashboard/services/web/lib/db.js +32 -0
  15. package/src/corpus/templates/admin-dashboard/services/web/package.json +16 -0
  16. package/src/corpus/templates/ai-app/cloudgrid.yaml +225 -11
  17. package/src/corpus/templates/ai-app/index.md +3 -11
  18. package/src/corpus/templates/ai-knowledge-base/AGENTS.md +254 -0
  19. package/src/corpus/templates/ai-knowledge-base/README.md +28 -0
  20. package/src/corpus/templates/ai-knowledge-base/cloudgrid.yaml +238 -0
  21. package/src/corpus/templates/ai-knowledge-base/index.md +81 -0
  22. package/src/corpus/templates/analytics-dashboard/README.md +85 -0
  23. package/src/corpus/templates/analytics-dashboard/cloudgrid.yaml +232 -0
  24. package/src/corpus/templates/analytics-dashboard/index.md +316 -0
  25. package/src/corpus/templates/analytics-dashboard/services/web/app/api/events/route.js +60 -0
  26. package/src/corpus/templates/analytics-dashboard/services/web/app/event-form.js +100 -0
  27. package/src/corpus/templates/analytics-dashboard/services/web/app/layout.js +41 -0
  28. package/src/corpus/templates/analytics-dashboard/services/web/app/page.js +54 -0
  29. package/src/corpus/templates/analytics-dashboard/services/web/lib/db.js +32 -0
  30. package/src/corpus/templates/analytics-dashboard/services/web/package.json +16 -0
  31. package/src/corpus/templates/api-dashboard/README.md +84 -0
  32. package/src/corpus/templates/api-dashboard/cloudgrid.yaml +233 -0
  33. package/src/corpus/templates/api-dashboard/index.md +310 -0
  34. package/src/corpus/templates/api-dashboard/services/web/app/api/requests/route.js +62 -0
  35. package/src/corpus/templates/api-dashboard/services/web/app/dashboard.js +156 -0
  36. package/src/corpus/templates/api-dashboard/services/web/app/layout.js +42 -0
  37. package/src/corpus/templates/api-dashboard/services/web/app/page.js +39 -0
  38. package/src/corpus/templates/api-dashboard/services/web/lib/db.js +32 -0
  39. package/src/corpus/templates/api-dashboard/services/web/package.json +16 -0
  40. package/src/corpus/templates/api-docs/README.md +28 -0
  41. package/src/corpus/templates/api-docs/cloudgrid.yaml +228 -0
  42. package/src/corpus/templates/api-docs/index.html +136 -0
  43. package/src/corpus/templates/api-docs/index.md +28 -0
  44. package/src/corpus/templates/api-service/cloudgrid.yaml +224 -9
  45. package/src/corpus/templates/api-service/index.md +3 -11
  46. package/src/corpus/templates/app-with-data/cloudgrid.yaml +226 -8
  47. package/src/corpus/templates/app-with-data/index.md +3 -8
  48. package/src/corpus/templates/appointment-booking/AGENTS.md +223 -0
  49. package/src/corpus/templates/appointment-booking/README.md +16 -0
  50. package/src/corpus/templates/appointment-booking/cloudgrid.yaml +250 -0
  51. package/src/corpus/templates/appointment-booking/index.md +72 -0
  52. package/src/corpus/templates/approval-workflow/AGENTS.md +170 -0
  53. package/src/corpus/templates/approval-workflow/README.md +12 -0
  54. package/src/corpus/templates/approval-workflow/cloudgrid.yaml +237 -0
  55. package/src/corpus/templates/approval-workflow/index.md +58 -0
  56. package/src/corpus/templates/billing-dashboard/AGENTS.md +199 -0
  57. package/src/corpus/templates/billing-dashboard/README.md +18 -0
  58. package/src/corpus/templates/billing-dashboard/cloudgrid.yaml +235 -0
  59. package/src/corpus/templates/billing-dashboard/index.md +87 -0
  60. package/src/corpus/templates/blog-cms/README.md +94 -0
  61. package/src/corpus/templates/blog-cms/cloudgrid.yaml +233 -0
  62. package/src/corpus/templates/blog-cms/index.md +358 -0
  63. package/src/corpus/templates/blog-cms/services/web/app/admin/admin-editor.js +133 -0
  64. package/src/corpus/templates/blog-cms/services/web/app/admin/page.js +33 -0
  65. package/src/corpus/templates/blog-cms/services/web/app/api/posts/route.js +84 -0
  66. package/src/corpus/templates/blog-cms/services/web/app/layout.js +47 -0
  67. package/src/corpus/templates/blog-cms/services/web/app/page.js +56 -0
  68. package/src/corpus/templates/blog-cms/services/web/app/posts/[slug]/page.js +45 -0
  69. package/src/corpus/templates/blog-cms/services/web/lib/db.js +32 -0
  70. package/src/corpus/templates/blog-cms/services/web/package.json +16 -0
  71. package/src/corpus/templates/booking-system/AGENTS.md +189 -0
  72. package/src/corpus/templates/booking-system/README.md +17 -0
  73. package/src/corpus/templates/booking-system/cloudgrid.yaml +248 -0
  74. package/src/corpus/templates/booking-system/index.md +86 -0
  75. package/src/corpus/templates/calendar-scheduler/AGENTS.md +226 -0
  76. package/src/corpus/templates/calendar-scheduler/README.md +25 -0
  77. package/src/corpus/templates/calendar-scheduler/cloudgrid.yaml +259 -0
  78. package/src/corpus/templates/calendar-scheduler/index.md +85 -0
  79. package/src/corpus/templates/changelog/README.md +27 -0
  80. package/src/corpus/templates/changelog/cloudgrid.yaml +228 -0
  81. package/src/corpus/templates/changelog/index.html +80 -0
  82. package/src/corpus/templates/changelog/index.md +28 -0
  83. package/src/corpus/templates/company-website/README.md +54 -0
  84. package/src/corpus/templates/company-website/cloudgrid.yaml +233 -0
  85. package/src/corpus/templates/company-website/index.html +309 -0
  86. package/src/corpus/templates/company-website/index.md +29 -0
  87. package/src/corpus/templates/course-platform/AGENTS.md +161 -0
  88. package/src/corpus/templates/course-platform/README.md +26 -0
  89. package/src/corpus/templates/course-platform/cloudgrid.yaml +237 -0
  90. package/src/corpus/templates/course-platform/index.md +70 -0
  91. package/src/corpus/templates/crm/README.md +72 -0
  92. package/src/corpus/templates/crm/cloudgrid.yaml +233 -0
  93. package/src/corpus/templates/crm/index.md +71 -0
  94. package/src/corpus/templates/crm/services/web/app/api/contacts/route.js +80 -0
  95. package/src/corpus/templates/crm/services/web/app/contact-manager.js +102 -0
  96. package/src/corpus/templates/crm/services/web/app/layout.js +35 -0
  97. package/src/corpus/templates/crm/services/web/app/page.js +34 -0
  98. package/src/corpus/templates/crm/services/web/lib/db.js +32 -0
  99. package/src/corpus/templates/crm/services/web/package.json +16 -0
  100. package/src/corpus/templates/dashboard/cloudgrid.yaml +228 -4
  101. package/src/corpus/templates/dashboard/index.md +3 -5
  102. package/src/corpus/templates/deck/cloudgrid.yaml +228 -4
  103. package/src/corpus/templates/deck/index.md +3 -5
  104. package/src/corpus/templates/directory/README.md +75 -0
  105. package/src/corpus/templates/directory/cloudgrid.yaml +233 -0
  106. package/src/corpus/templates/directory/index.md +334 -0
  107. package/src/corpus/templates/directory/services/web/app/api/entries/route.js +63 -0
  108. package/src/corpus/templates/directory/services/web/app/directory-list.js +146 -0
  109. package/src/corpus/templates/directory/services/web/app/layout.js +44 -0
  110. package/src/corpus/templates/directory/services/web/app/page.js +38 -0
  111. package/src/corpus/templates/directory/services/web/lib/db.js +32 -0
  112. package/src/corpus/templates/directory/services/web/package.json +16 -0
  113. package/src/corpus/templates/docs-site/README.md +28 -0
  114. package/src/corpus/templates/docs-site/cloudgrid.yaml +228 -0
  115. package/src/corpus/templates/docs-site/index.html +122 -0
  116. package/src/corpus/templates/docs-site/index.md +28 -0
  117. package/src/corpus/templates/erp/AGENTS.md +116 -0
  118. package/src/corpus/templates/erp/README.md +17 -0
  119. package/src/corpus/templates/erp/cloudgrid.yaml +235 -0
  120. package/src/corpus/templates/erp/index.md +81 -0
  121. package/src/corpus/templates/event-board/README.md +74 -0
  122. package/src/corpus/templates/event-board/cloudgrid.yaml +233 -0
  123. package/src/corpus/templates/event-board/index.md +299 -0
  124. package/src/corpus/templates/event-board/services/web/app/api/events/route.js +61 -0
  125. package/src/corpus/templates/event-board/services/web/app/event-form.js +118 -0
  126. package/src/corpus/templates/event-board/services/web/app/layout.js +39 -0
  127. package/src/corpus/templates/event-board/services/web/app/page.js +34 -0
  128. package/src/corpus/templates/event-board/services/web/lib/db.js +32 -0
  129. package/src/corpus/templates/event-board/services/web/package.json +16 -0
  130. package/src/corpus/templates/expense-tracker/README.md +76 -0
  131. package/src/corpus/templates/expense-tracker/cloudgrid.yaml +233 -0
  132. package/src/corpus/templates/expense-tracker/index.md +305 -0
  133. package/src/corpus/templates/expense-tracker/services/web/app/api/expenses/route.js +61 -0
  134. package/src/corpus/templates/expense-tracker/services/web/app/expense-form.js +145 -0
  135. package/src/corpus/templates/expense-tracker/services/web/app/layout.js +42 -0
  136. package/src/corpus/templates/expense-tracker/services/web/app/page.js +34 -0
  137. package/src/corpus/templates/expense-tracker/services/web/lib/db.js +32 -0
  138. package/src/corpus/templates/expense-tracker/services/web/package.json +16 -0
  139. package/src/corpus/templates/feature-request-board/README.md +87 -0
  140. package/src/corpus/templates/feature-request-board/cloudgrid.yaml +233 -0
  141. package/src/corpus/templates/feature-request-board/index.md +317 -0
  142. package/src/corpus/templates/feature-request-board/services/web/app/api/requests/route.js +92 -0
  143. package/src/corpus/templates/feature-request-board/services/web/app/board.js +91 -0
  144. package/src/corpus/templates/feature-request-board/services/web/app/layout.js +43 -0
  145. package/src/corpus/templates/feature-request-board/services/web/app/page.js +35 -0
  146. package/src/corpus/templates/feature-request-board/services/web/lib/db.js +32 -0
  147. package/src/corpus/templates/feature-request-board/services/web/package.json +16 -0
  148. package/src/corpus/templates/financial-dashboard/README.md +80 -0
  149. package/src/corpus/templates/financial-dashboard/cloudgrid.yaml +233 -0
  150. package/src/corpus/templates/financial-dashboard/index.md +326 -0
  151. package/src/corpus/templates/financial-dashboard/services/web/app/api/entries/route.js +63 -0
  152. package/src/corpus/templates/financial-dashboard/services/web/app/entry-board.js +130 -0
  153. package/src/corpus/templates/financial-dashboard/services/web/app/layout.js +46 -0
  154. package/src/corpus/templates/financial-dashboard/services/web/app/page.js +31 -0
  155. package/src/corpus/templates/financial-dashboard/services/web/lib/db.js +32 -0
  156. package/src/corpus/templates/financial-dashboard/services/web/package.json +16 -0
  157. package/src/corpus/templates/forum/AGENTS.md +196 -0
  158. package/src/corpus/templates/forum/README.md +12 -0
  159. package/src/corpus/templates/forum/cloudgrid.yaml +237 -0
  160. package/src/corpus/templates/forum/index.md +66 -0
  161. package/src/corpus/templates/hr-portal/AGENTS.md +174 -0
  162. package/src/corpus/templates/hr-portal/README.md +14 -0
  163. package/src/corpus/templates/hr-portal/cloudgrid.yaml +237 -0
  164. package/src/corpus/templates/hr-portal/index.md +56 -0
  165. package/src/corpus/templates/internal-tools-portal/AGENTS.md +201 -0
  166. package/src/corpus/templates/internal-tools-portal/README.md +17 -0
  167. package/src/corpus/templates/internal-tools-portal/cloudgrid.yaml +237 -0
  168. package/src/corpus/templates/internal-tools-portal/index.md +62 -0
  169. package/src/corpus/templates/inventory/README.md +71 -0
  170. package/src/corpus/templates/inventory/cloudgrid.yaml +233 -0
  171. package/src/corpus/templates/inventory/index.md +68 -0
  172. package/src/corpus/templates/inventory/services/web/app/api/items/route.js +88 -0
  173. package/src/corpus/templates/inventory/services/web/app/inventory-manager.js +101 -0
  174. package/src/corpus/templates/inventory/services/web/app/layout.js +36 -0
  175. package/src/corpus/templates/inventory/services/web/app/page.js +37 -0
  176. package/src/corpus/templates/inventory/services/web/lib/db.js +32 -0
  177. package/src/corpus/templates/inventory/services/web/package.json +16 -0
  178. package/src/corpus/templates/invoice/README.md +71 -0
  179. package/src/corpus/templates/invoice/cloudgrid.yaml +233 -0
  180. package/src/corpus/templates/invoice/index.md +68 -0
  181. package/src/corpus/templates/invoice/services/web/app/api/invoices/route.js +82 -0
  182. package/src/corpus/templates/invoice/services/web/app/invoice-manager.js +101 -0
  183. package/src/corpus/templates/invoice/services/web/app/layout.js +35 -0
  184. package/src/corpus/templates/invoice/services/web/app/page.js +34 -0
  185. package/src/corpus/templates/invoice/services/web/lib/db.js +32 -0
  186. package/src/corpus/templates/invoice/services/web/package.json +16 -0
  187. package/src/corpus/templates/job-board/README.md +71 -0
  188. package/src/corpus/templates/job-board/cloudgrid.yaml +233 -0
  189. package/src/corpus/templates/job-board/index.md +68 -0
  190. package/src/corpus/templates/job-board/services/web/app/api/jobs/route.js +66 -0
  191. package/src/corpus/templates/job-board/services/web/app/job-board.js +73 -0
  192. package/src/corpus/templates/job-board/services/web/app/layout.js +35 -0
  193. package/src/corpus/templates/job-board/services/web/app/page.js +32 -0
  194. package/src/corpus/templates/job-board/services/web/lib/db.js +32 -0
  195. package/src/corpus/templates/job-board/services/web/package.json +16 -0
  196. package/src/corpus/templates/kanban/README.md +72 -0
  197. package/src/corpus/templates/kanban/cloudgrid.yaml +233 -0
  198. package/src/corpus/templates/kanban/index.md +71 -0
  199. package/src/corpus/templates/kanban/services/web/app/api/cards/route.js +70 -0
  200. package/src/corpus/templates/kanban/services/web/app/board.js +93 -0
  201. package/src/corpus/templates/kanban/services/web/app/layout.js +37 -0
  202. package/src/corpus/templates/kanban/services/web/app/page.js +32 -0
  203. package/src/corpus/templates/kanban/services/web/lib/db.js +32 -0
  204. package/src/corpus/templates/kanban/services/web/package.json +16 -0
  205. package/src/corpus/templates/landing-page/cloudgrid.yaml +228 -4
  206. package/src/corpus/templates/landing-page/index.md +3 -5
  207. package/src/corpus/templates/lms/AGENTS.md +193 -0
  208. package/src/corpus/templates/lms/README.md +27 -0
  209. package/src/corpus/templates/lms/cloudgrid.yaml +237 -0
  210. package/src/corpus/templates/lms/index.md +79 -0
  211. package/src/corpus/templates/marketplace/AGENTS.md +208 -0
  212. package/src/corpus/templates/marketplace/README.md +22 -0
  213. package/src/corpus/templates/marketplace/cloudgrid.yaml +233 -0
  214. package/src/corpus/templates/marketplace/index.md +76 -0
  215. package/src/corpus/templates/membership-site/AGENTS.md +160 -0
  216. package/src/corpus/templates/membership-site/README.md +18 -0
  217. package/src/corpus/templates/membership-site/cloudgrid.yaml +236 -0
  218. package/src/corpus/templates/membership-site/index.md +66 -0
  219. package/src/corpus/templates/monitoring-dashboard/README.md +84 -0
  220. package/src/corpus/templates/monitoring-dashboard/cloudgrid.yaml +233 -0
  221. package/src/corpus/templates/monitoring-dashboard/index.md +328 -0
  222. package/src/corpus/templates/monitoring-dashboard/services/web/app/api/checks/route.js +76 -0
  223. package/src/corpus/templates/monitoring-dashboard/services/web/app/check-form.js +124 -0
  224. package/src/corpus/templates/monitoring-dashboard/services/web/app/layout.js +44 -0
  225. package/src/corpus/templates/monitoring-dashboard/services/web/app/page.js +49 -0
  226. package/src/corpus/templates/monitoring-dashboard/services/web/lib/db.js +32 -0
  227. package/src/corpus/templates/monitoring-dashboard/services/web/package.json +16 -0
  228. package/src/corpus/templates/online-store/AGENTS.md +153 -0
  229. package/src/corpus/templates/online-store/README.md +16 -0
  230. package/src/corpus/templates/online-store/cloudgrid.yaml +234 -0
  231. package/src/corpus/templates/online-store/index.md +81 -0
  232. package/src/corpus/templates/portfolio/README.md +29 -0
  233. package/src/corpus/templates/portfolio/cloudgrid.yaml +228 -0
  234. package/src/corpus/templates/portfolio/index.html +126 -0
  235. package/src/corpus/templates/portfolio/index.md +28 -0
  236. package/src/corpus/templates/product-catalog/README.md +74 -0
  237. package/src/corpus/templates/product-catalog/cloudgrid.yaml +232 -0
  238. package/src/corpus/templates/product-catalog/index.md +330 -0
  239. package/src/corpus/templates/product-catalog/services/web/app/api/products/route.js +69 -0
  240. package/src/corpus/templates/product-catalog/services/web/app/catalog.js +153 -0
  241. package/src/corpus/templates/product-catalog/services/web/app/layout.js +49 -0
  242. package/src/corpus/templates/product-catalog/services/web/app/page.js +36 -0
  243. package/src/corpus/templates/product-catalog/services/web/lib/db.js +32 -0
  244. package/src/corpus/templates/product-catalog/services/web/package.json +16 -0
  245. package/src/corpus/templates/product-launch/README.md +46 -0
  246. package/src/corpus/templates/product-launch/cloudgrid.yaml +234 -0
  247. package/src/corpus/templates/product-launch/index.html +320 -0
  248. package/src/corpus/templates/product-launch/index.md +34 -0
  249. package/src/corpus/templates/project-management/README.md +83 -0
  250. package/src/corpus/templates/project-management/cloudgrid.yaml +233 -0
  251. package/src/corpus/templates/project-management/index.md +346 -0
  252. package/src/corpus/templates/project-management/services/web/app/api/projects/route.js +48 -0
  253. package/src/corpus/templates/project-management/services/web/app/api/tasks/route.js +85 -0
  254. package/src/corpus/templates/project-management/services/web/app/board.js +182 -0
  255. package/src/corpus/templates/project-management/services/web/app/layout.js +45 -0
  256. package/src/corpus/templates/project-management/services/web/app/page.js +49 -0
  257. package/src/corpus/templates/project-management/services/web/lib/db.js +32 -0
  258. package/src/corpus/templates/project-management/services/web/package.json +16 -0
  259. package/src/corpus/templates/property-listings/README.md +76 -0
  260. package/src/corpus/templates/property-listings/cloudgrid.yaml +233 -0
  261. package/src/corpus/templates/property-listings/index.md +335 -0
  262. package/src/corpus/templates/property-listings/services/web/app/api/properties/route.js +73 -0
  263. package/src/corpus/templates/property-listings/services/web/app/layout.js +45 -0
  264. package/src/corpus/templates/property-listings/services/web/app/listings.js +152 -0
  265. package/src/corpus/templates/property-listings/services/web/app/page.js +53 -0
  266. package/src/corpus/templates/property-listings/services/web/lib/db.js +32 -0
  267. package/src/corpus/templates/property-listings/services/web/package.json +16 -0
  268. package/src/corpus/templates/quiz-platform/README.md +84 -0
  269. package/src/corpus/templates/quiz-platform/cloudgrid.yaml +233 -0
  270. package/src/corpus/templates/quiz-platform/index.md +313 -0
  271. package/src/corpus/templates/quiz-platform/services/web/app/api/questions/route.js +69 -0
  272. package/src/corpus/templates/quiz-platform/services/web/app/layout.js +47 -0
  273. package/src/corpus/templates/quiz-platform/services/web/app/page.js +37 -0
  274. package/src/corpus/templates/quiz-platform/services/web/app/quiz.js +188 -0
  275. package/src/corpus/templates/quiz-platform/services/web/lib/db.js +32 -0
  276. package/src/corpus/templates/quiz-platform/services/web/package.json +16 -0
  277. package/src/corpus/templates/report/cloudgrid.yaml +228 -4
  278. package/src/corpus/templates/report/index.md +3 -5
  279. package/src/corpus/templates/restaurant-reservations/AGENTS.md +258 -0
  280. package/src/corpus/templates/restaurant-reservations/README.md +17 -0
  281. package/src/corpus/templates/restaurant-reservations/cloudgrid.yaml +258 -0
  282. package/src/corpus/templates/restaurant-reservations/index.md +62 -0
  283. package/src/corpus/templates/revenue-dashboard/README.md +75 -0
  284. package/src/corpus/templates/revenue-dashboard/cloudgrid.yaml +233 -0
  285. package/src/corpus/templates/revenue-dashboard/index.md +307 -0
  286. package/src/corpus/templates/revenue-dashboard/services/web/app/api/sales/route.js +60 -0
  287. package/src/corpus/templates/revenue-dashboard/services/web/app/layout.js +40 -0
  288. package/src/corpus/templates/revenue-dashboard/services/web/app/page.js +87 -0
  289. package/src/corpus/templates/revenue-dashboard/services/web/app/sale-form.js +63 -0
  290. package/src/corpus/templates/revenue-dashboard/services/web/lib/db.js +32 -0
  291. package/src/corpus/templates/revenue-dashboard/services/web/package.json +16 -0
  292. package/src/corpus/templates/saas-marketing/README.md +30 -0
  293. package/src/corpus/templates/saas-marketing/cloudgrid.yaml +228 -0
  294. package/src/corpus/templates/saas-marketing/index.html +212 -0
  295. package/src/corpus/templates/saas-marketing/index.md +28 -0
  296. package/src/corpus/templates/status-page/README.md +28 -0
  297. package/src/corpus/templates/status-page/cloudgrid.yaml +228 -0
  298. package/src/corpus/templates/status-page/index.html +117 -0
  299. package/src/corpus/templates/status-page/index.md +28 -0
  300. package/src/corpus/templates/subscription-management/AGENTS.md +191 -0
  301. package/src/corpus/templates/subscription-management/README.md +21 -0
  302. package/src/corpus/templates/subscription-management/cloudgrid.yaml +236 -0
  303. package/src/corpus/templates/subscription-management/index.md +73 -0
  304. package/src/corpus/templates/task-manager/README.md +72 -0
  305. package/src/corpus/templates/task-manager/cloudgrid.yaml +233 -0
  306. package/src/corpus/templates/task-manager/index.md +71 -0
  307. package/src/corpus/templates/task-manager/services/web/app/api/tasks/route.js +77 -0
  308. package/src/corpus/templates/task-manager/services/web/app/layout.js +39 -0
  309. package/src/corpus/templates/task-manager/services/web/app/page.js +33 -0
  310. package/src/corpus/templates/task-manager/services/web/app/task-list.js +110 -0
  311. package/src/corpus/templates/task-manager/services/web/lib/db.js +32 -0
  312. package/src/corpus/templates/task-manager/services/web/package.json +16 -0
  313. package/src/corpus/templates/ticket-system/README.md +71 -0
  314. package/src/corpus/templates/ticket-system/cloudgrid.yaml +233 -0
  315. package/src/corpus/templates/ticket-system/index.md +68 -0
  316. package/src/corpus/templates/ticket-system/services/web/app/api/tickets/route.js +81 -0
  317. package/src/corpus/templates/ticket-system/services/web/app/layout.js +36 -0
  318. package/src/corpus/templates/ticket-system/services/web/app/page.js +35 -0
  319. package/src/corpus/templates/ticket-system/services/web/app/ticket-queue.js +112 -0
  320. package/src/corpus/templates/ticket-system/services/web/lib/db.js +32 -0
  321. package/src/corpus/templates/ticket-system/services/web/package.json +16 -0
  322. package/src/corpus/templates/time-tracking/README.md +81 -0
  323. package/src/corpus/templates/time-tracking/cloudgrid.yaml +233 -0
  324. package/src/corpus/templates/time-tracking/index.md +298 -0
  325. package/src/corpus/templates/time-tracking/services/web/app/api/entries/route.js +66 -0
  326. package/src/corpus/templates/time-tracking/services/web/app/entry-form.js +106 -0
  327. package/src/corpus/templates/time-tracking/services/web/app/layout.js +39 -0
  328. package/src/corpus/templates/time-tracking/services/web/app/page.js +30 -0
  329. package/src/corpus/templates/time-tracking/services/web/lib/db.js +32 -0
  330. package/src/corpus/templates/time-tracking/services/web/package.json +16 -0
  331. package/src/corpus/templates/travel-booking/AGENTS.md +207 -0
  332. package/src/corpus/templates/travel-booking/README.md +17 -0
  333. package/src/corpus/templates/travel-booking/cloudgrid.yaml +249 -0
  334. package/src/corpus/templates/travel-booking/index.md +88 -0
  335. package/src/corpus/templates/waitlist/README.md +38 -0
  336. package/src/corpus/templates/waitlist/cloudgrid.yaml +228 -0
  337. package/src/corpus/templates/waitlist/index.html +69 -0
  338. package/src/corpus/templates/waitlist/index.md +39 -0
  339. package/src/corpus/templates/web-app/cloudgrid.yaml +228 -4
  340. package/src/corpus/templates/web-app/index.md +3 -5
  341. package/src/corpus/workflows/admin-dashboard.md +102 -0
  342. package/src/corpus/workflows/ai-knowledge-base.md +137 -0
  343. package/src/corpus/workflows/analytics-dashboard.md +104 -0
  344. package/src/corpus/workflows/api-dashboard.md +102 -0
  345. package/src/corpus/workflows/api-docs.md +36 -0
  346. package/src/corpus/workflows/appointment-booking.md +143 -0
  347. package/src/corpus/workflows/approval-workflow.md +124 -0
  348. package/src/corpus/workflows/billing-dashboard.md +120 -0
  349. package/src/corpus/workflows/blog-cms.md +104 -0
  350. package/src/corpus/workflows/booking-system.md +116 -0
  351. package/src/corpus/workflows/calendar-scheduler.md +134 -0
  352. package/src/corpus/workflows/changelog.md +33 -0
  353. package/src/corpus/workflows/company-website.md +46 -0
  354. package/src/corpus/workflows/course-platform.md +126 -0
  355. package/src/corpus/workflows/crm.md +101 -0
  356. package/src/corpus/workflows/directory.md +101 -0
  357. package/src/corpus/workflows/docs-site.md +35 -0
  358. package/src/corpus/workflows/erp.md +125 -0
  359. package/src/corpus/workflows/event-board.md +102 -0
  360. package/src/corpus/workflows/expense-tracker.md +102 -0
  361. package/src/corpus/workflows/feature-request-board.md +105 -0
  362. package/src/corpus/workflows/financial-dashboard.md +103 -0
  363. package/src/corpus/workflows/forum.md +128 -0
  364. package/src/corpus/workflows/hr-portal.md +115 -0
  365. package/src/corpus/workflows/internal-tools-portal.md +125 -0
  366. package/src/corpus/workflows/inventory.md +101 -0
  367. package/src/corpus/workflows/invoice.md +101 -0
  368. package/src/corpus/workflows/job-board.md +101 -0
  369. package/src/corpus/workflows/kanban.md +102 -0
  370. package/src/corpus/workflows/lms.md +113 -0
  371. package/src/corpus/workflows/marketplace.md +123 -0
  372. package/src/corpus/workflows/membership-site.md +128 -0
  373. package/src/corpus/workflows/monitoring-dashboard.md +104 -0
  374. package/src/corpus/workflows/online-store.md +114 -0
  375. package/src/corpus/workflows/portfolio.md +35 -0
  376. package/src/corpus/workflows/product-catalog.md +105 -0
  377. package/src/corpus/workflows/product-launch.md +43 -0
  378. package/src/corpus/workflows/project-management.md +106 -0
  379. package/src/corpus/workflows/property-listings.md +101 -0
  380. package/src/corpus/workflows/quiz-platform.md +105 -0
  381. package/src/corpus/workflows/restaurant-reservations.md +123 -0
  382. package/src/corpus/workflows/revenue-dashboard.md +102 -0
  383. package/src/corpus/workflows/saas-marketing.md +37 -0
  384. package/src/corpus/workflows/status-page.md +35 -0
  385. package/src/corpus/workflows/subscription-management.md +141 -0
  386. package/src/corpus/workflows/task-manager.md +101 -0
  387. package/src/corpus/workflows/ticket-system.md +101 -0
  388. package/src/corpus/workflows/time-tracking.md +104 -0
  389. package/src/corpus/workflows/travel-booking.md +115 -0
  390. package/src/corpus/workflows/waitlist.md +42 -0
@@ -0,0 +1,233 @@
1
+ # ============================================================================
2
+ # cloudgrid.yaml — Complete Example
3
+ # ============================================================================
4
+ #
5
+ # This file shows EVERY field the platform supports, with comments explaining
6
+ # each one. It is a reference — no real project would use all of these at once.
7
+ #
8
+ # STANDARD: every CloudGrid template ships its cloudgrid.yaml in THIS full form.
9
+ # Uncomment ONLY the fields the archetype needs (always: name + services; plus
10
+ # needs: for runtime apps). Leave everything else commented. Comments are
11
+ # ignored by the parser, so the file deploys to exactly the active fields.
12
+ #
13
+ # Only two fields are required: name and services. Everything else is optional.
14
+ # Full docs: docs/cloudgrid-yaml-reference.md
15
+ # ============================================================================
16
+
17
+
18
+ # ─── IDENTITY ───────────────────────────────────────────────────────────────
19
+
20
+ # Entity slug (REQUIRED). 2-42 chars, lowercase alphanumeric + hyphens.
21
+ # Must start and end with a letter or digit.
22
+ # Becomes part of your public URL: <name>-<4hex>.<org>.cloudgrid.io
23
+ name: my-tickets
24
+
25
+ # One-line summary. Max 280 chars. If omitted, Grid Brain auto-generates one.
26
+ # description: Order processing API for the e-commerce platform
27
+
28
+ # Single emoji or short text shown as the entity icon. Max 64 chars.
29
+ # icon: "📦"
30
+
31
+ # Entity type: 'app' (default) or 'agent'. An agent is an app with an agent: block.
32
+ # kind: app
33
+
34
+
35
+ # ─── NETWORKING ─────────────────────────────────────────────────────────────
36
+
37
+ # Whether this entity serves public HTTP traffic.
38
+ # true = public URL + Ingress (default). false = internal only.
39
+ # expose: true
40
+
41
+ # Additional domain names this entity serves on (the platform URL is always active).
42
+ # custom_domains:
43
+ # - orders.example.com
44
+ # - shop.example.com
45
+
46
+
47
+ # ─── HEALTH PROBE (entity-level override) ──────────────────────────────────
48
+
49
+ # Override the default health check for the entire entity.
50
+ # probe:
51
+ # path: /healthz # HTTP path to probe (default: /).
52
+ # expected: "<500" # '<500' (default), '200', '2xx'.
53
+
54
+
55
+ # ─── DEPLOY NOTIFICATIONS ──────────────────────────────────────────────────
56
+
57
+ # Slack notification to the org's default channel on deploy failure.
58
+ # true = notify (default), false = silent.
59
+ # notify: true
60
+
61
+
62
+ # ─── SCALING ────────────────────────────────────────────────────────────────
63
+
64
+ # Replica scaling intent.
65
+ # 'auto' — platform decides from the grid tier (default).
66
+ # 'alert' — single-replica, emit a SPOF warning at plug time.
67
+ # 1-10 — explicit replica count, clamped to the grid max.
68
+ # scale: auto
69
+
70
+
71
+ # ─── INFRASTRUCTURE NEEDS ──────────────────────────────────────────────────
72
+ #
73
+ # Declare infrastructure; the platform provisions it and injects connection
74
+ # details as env vars. Nine needs: database, cache, kv, queue, pubsub, vector,
75
+ # object_storage, disk, ai. Simplest form is `true`.
76
+ #
77
+ # needs:
78
+ # # database — MongoDB. Injects DATABASE_MONGODB_URL (+ legacy MONGODB_URL).
79
+ # # true | pool | dedicated | { tier: external, secret: MY_DB }
80
+ # database: true
81
+ # # cache — Redis, LRU eviction (derived data). Injects CACHE_REDIS_URL (+ REDIS_URL).
82
+ # # true | redis | { engine: external, secret: MY_REDIS_URL }
83
+ # cache: true
84
+ # # kv — Redis, no eviction (durable: flags, idempotency). Injects KV_REDIS_URL.
85
+ # kv: true
86
+ # # queue — Redis job-queue substrate (BullMQ). Injects QUEUE_REDIS_URL.
87
+ # queue: true
88
+ # # pubsub — Redis broadcast pub/sub. Injects PUBSUB_REDIS_URL.
89
+ # pubsub: true
90
+ # # vector — pgvector on Postgres. Injects VECTOR_PGVECTOR_URL (+ PGVECTOR_URL).
91
+ # # true | pgvector | { engine: pgvector, dim: 1536 }
92
+ # vector: pgvector
93
+ # # object_storage — GCS bucket. Injects OBJECT_STORAGE_GCS_BUCKET, _GCS_REGION.
94
+ # # true | { size: 10Gi }
95
+ # object_storage: true
96
+ # # disk — persistent FS mount (PVC). Injects DISK_PATH. Pins to 1 replica.
97
+ # # true | { size: 1Gi, mount: /var/data } (forbidden: /proc /sys /dev)
98
+ # disk: true
99
+ # # ai — AI Gateway via @cloudgrid-io/ai. Injects AI_GATEWAY_URL. true | false.
100
+ # ai: true
101
+
102
+
103
+ # ─── INTER-ENTITY COMMUNICATION ────────────────────────────────────────────
104
+
105
+ # Entities this app calls (outbound). Service-account token injected per pair.
106
+ # calls:
107
+ # - org:atomic/billing-api
108
+
109
+ # Inbound caller policy — who can call YOUR entity.
110
+ # callers:
111
+ # policy: auto # 'auto' | 'manual' (default).
112
+ # scope: org # 'org' (default) | 'space' | 'explicit'.
113
+ # fallback: deny # 'deny' (default) | 'warn'.
114
+ # # allowed_apps: # required only when scope: explicit
115
+ # # - org:atomic/frontend
116
+
117
+
118
+ # ─── VAULT ──────────────────────────────────────────────────────────────────
119
+
120
+ # Map org vault items to env vars. Keys UPPER_SNAKE_CASE; values = vault item keys.
121
+ # vault:
122
+ # STRIPE_KEY: stripe-live-key
123
+ # SENDGRID_API_KEY: sendgrid-key
124
+
125
+
126
+ # ─── CONNECTORS AND HOOKS ──────────────────────────────────────────────────
127
+
128
+ # connectors:
129
+ # - id: team-slack
130
+ # target: org # 'system' | 'org'.
131
+ # channel: "#deploys"
132
+ # hooks:
133
+ # - on: deploy.failed # release.published | deploy.failed | feedback.received | entity.created
134
+ # via: team-slack
135
+ # template: "Deploy failed for {entity_name}: {error}"
136
+ # channel: "#alerts"
137
+ # triggers:
138
+ # - from: team-slack
139
+ # event: message
140
+ # channel: "#support"
141
+ # route: /webhooks/slack
142
+
143
+
144
+ # ─── LOCAL DEVELOPMENT ──────────────────────────────────────────────────────
145
+
146
+ # Config for `grid dev`. Redact fields in dev data snapshots.
147
+ # dev:
148
+ # snapshot:
149
+ # mask:
150
+ # - users.email
151
+ # - users.phone
152
+
153
+
154
+ # ─── AGENT METADATA ────────────────────────────────────────────────────────
155
+
156
+ # An agent is an app with kind: agent (above) and an agent: block.
157
+ # agent:
158
+ # purpose: Sync customer data from external CRM every night
159
+ # schedule: "0 2 * * *"
160
+ # trigger: webhook
161
+
162
+
163
+ # ─── PRIVATE RESOURCE AUTO-DEPENDENCIES ────────────────────────────────────
164
+
165
+ # When true (default), private resources are auto-injected as depends_on.
166
+ # auto_depends_on_private_requires: true
167
+
168
+
169
+ # ─── SERVICES (REQUIRED) ───────────────────────────────────────────────────
170
+ #
171
+ # At least one service is required. Key = service name (slug rules).
172
+ # Types: node, nextjs, python, static, cron.
173
+ #
174
+ services:
175
+ web:
176
+ # type (REQUIRED): node | nextjs | python | static | cron
177
+ type: nextjs
178
+ # HTTP route: '/' | '/api' | false (internal) | omitted (=false + warning).
179
+ # Only one service per entity can claim '/'.
180
+ path: /
181
+ # Container port (default 8080; read process.env.PORT). Not for cron.
182
+ # port: 3000
183
+ # nextjs only: base_image: distroless (default) | alpine
184
+ # base_image: distroless
185
+ # node only: lang: javascript (default) | typescript
186
+ # lang: typescript
187
+ # Custom source location (default services/<name>/). '.' = project root.
188
+ # source:
189
+ # path: src/worker
190
+ # Health probe: false/omitted (TCP) | true (/health) | "/path" | {path,expected}
191
+ # health:
192
+ # path: /api/health
193
+ # expected: "200"
194
+ # Static runtime env vars (strings). Reserved: PORT, APP_NAME, SERVICE_NAME,
195
+ # NODE_ENV, MONGODB_URL, REDIS_URL, AI_GATEWAY_URL, N8N_WEBHOOK_URL, CLOUDGRID_*.
196
+ # env:
197
+ # LOG_LEVEL: info
198
+ # Sibling services/private resources that must be Ready first (no cron, no cycles).
199
+ # depends_on:
200
+ # - worker
201
+ # Per-service needs override (merges with app-level needs).
202
+ # needs:
203
+ # queue: true
204
+ # Static-only build step:
205
+ # build:
206
+ # command: npm run build
207
+ # output: dist
208
+ # env:
209
+ # VITE_API_URL: https://api.example.com
210
+ # node_version: "22" # static build step: '18'|'20'|'22'|'24' (quoted)
211
+ # Cron-only: schedule (REQUIRED), timezone (UTC|EST|PST), run (job | https URL)
212
+ # schedule: "0 9 * * 1"
213
+ # timezone: UTC
214
+ # run: job
215
+ # Verbose per-service persistence (prefer needs.disk):
216
+ # persist:
217
+ # - name: scratch
218
+ # path: /tmp/scratch
219
+ # size: 500Mi
220
+
221
+
222
+
223
+ needs:
224
+ database: true
225
+
226
+
227
+ # ============================================================================
228
+ # NOTES
229
+ # - NOT here: org:/entity_id: (→ .cloudgrid/link.json), secrets (→ grid secrets set),
230
+ # Dockerfile (platform generates from services.*.type).
231
+ # - Deploy: grid plug | Local with grid resources: grid dev
232
+ # - Full reference: docs/cloudgrid-yaml-reference.md | CLI: docs/cli-reference.md
233
+ # ============================================================================
@@ -0,0 +1,68 @@
1
+ # Template: ticket-system (persistent Next.js + Mongo support ticket / helpdesk queue)
2
+
3
+ A real, deployable support ticket / helpdesk queue. Support tickets live in the grid-shared MongoDB, so they
4
+ survive refresh and are shared across sessions. Same proven shape as
5
+ `app-with-data`, adapted to a `tickets` domain (subject, requester, status, priority, body) with a table view and per-row status changes.
6
+
7
+ **Key rules (all proven by the app-with-data end-to-end deploy):**
8
+
9
+ 1. **Service code MUST live under `services/<name>/`, not the repo/template
10
+ root.** `path:` in `cloudgrid.yaml` is the URL mount, NOT the filesystem path.
11
+ The service named `web` → the CLI looks for `services/web/`. App files at the
12
+ root fail with `Error: Service directory not found: …/services/web`.
13
+ 2. **Read the DB connection string LAZILY (inside the getter), never at module
14
+ top level.** The grid injects it as `DATABASE_MONGODB_URL` (plus the legacy
15
+ `MONGODB_URL` alias) at dev-time and runtime; the app reads
16
+ `process.env.DATABASE_MONGODB_URL || process.env.MONGODB_URL` inside `getDb`.
17
+ A top-level read fails `next build`. Never hardcode a connection string; never
18
+ commit a secret.
19
+ 3. **Declare the datastore with `needs: { database: true }`.** The deployer
20
+ provisions Mongo and injects the connection string. `requires:` is the
21
+ deprecated v1 alias; don't author new yaml with it, and never set `needs:` and
22
+ `requires:` together (the validator rejects the combination).
23
+
24
+ ## File tree
25
+
26
+ ```
27
+ cloudgrid.yaml # full-annotated reference; active: name + services.web (nextjs) + needs: { database: true }
28
+ services/web/package.json # next, react, react-dom, mongodb driver only
29
+ services/web/lib/db.js # lazy Mongo client from DATABASE_MONGODB_URL (legacy MONGODB_URL fallback)
30
+ services/web/app/layout.js # root layout + inline CSS
31
+ services/web/app/page.js # server component: reads tickets from Mongo
32
+ services/web/app/ticket-queue.js # client table: POST / PATCH (status) / DELETE via the API
33
+ services/web/app/api/tickets/route.js # GET (list) / POST (add) / PATCH (status) / DELETE (remove)
34
+ ```
35
+
36
+ ## cloudgrid.yaml
37
+
38
+ ```yaml
39
+ # On disk this file is the full-annotated reference (templates/_cloudgrid.yaml.reference) with EVERY
40
+ # field present as a comment; only the fields below are uncommented, so it
41
+ # deploys to exactly these active fields.
42
+ name: my-tickets
43
+ services:
44
+ web:
45
+ type: nextjs
46
+ path: /
47
+ needs:
48
+ database: true
49
+ ```
50
+
51
+ > **Capability:** this template's need is `database: true`. The deployer
52
+ > provisions Mongo and injects `DATABASE_MONGODB_URL` (plus the legacy
53
+ > `MONGODB_URL` alias). `requires:` is the deprecated v1 alias — don't mix it with
54
+ > `needs:` (the validator rejects the combination). See the capability-map for
55
+ > the full injection table.
56
+
57
+ ## The tickets collection
58
+
59
+ Documents: `{ subject, requester, status, priority, body, createdAt }` where `status` is one of `open` / `pending` / `closed`. The API route on `tickets` does GET (list), POST (add), PATCH (change status), DELETE (remove); the page is a
60
+ server component that reads the collection and hands it to a client component.
61
+
62
+ ## Adapt it
63
+
64
+ - Rename the `tickets` collection to your data (`issues`, `requests`).
65
+ - Change the document fields; add assignees, tags, SLA due dates, timestamps.
66
+ - Add more routes/collections as the app grows.
67
+ - Add `cache: true` to `needs:` only if you actually need Redis.
68
+ - Run `grid dev` to test locally, `grid plug` to deploy (async — poll to live).
@@ -0,0 +1,81 @@
1
+ // App Router route handler for the `tickets` collection.
2
+ // GET -> list tickets, POST -> add a ticket, PATCH -> change status,
3
+ // DELETE -> remove a ticket by id.
4
+ //
5
+ // To adapt this app, rename the collection and change the fields to match your
6
+ // own data (e.g. an `issues` or `requests` collection).
7
+ import { NextResponse } from "next/server";
8
+ import { ObjectId } from "mongodb";
9
+ import { getDb } from "../../../lib/db.js";
10
+
11
+ // Never cache — always read/write live data.
12
+ export const dynamic = "force-dynamic";
13
+
14
+ const STATUSES = ["open", "pending", "closed"];
15
+ const PRIORITIES = ["low", "normal", "high", "urgent"];
16
+
17
+ async function tickets() {
18
+ const db = await getDb();
19
+ return db.collection("tickets");
20
+ }
21
+
22
+ function shape(t) {
23
+ return {
24
+ id: t._id.toString(),
25
+ subject: t.subject || "",
26
+ requester: t.requester || "",
27
+ status: STATUSES.includes(t.status) ? t.status : "open",
28
+ priority: PRIORITIES.includes(t.priority) ? t.priority : "normal",
29
+ body: t.body || "",
30
+ };
31
+ }
32
+
33
+ // GET /api/tickets — list all tickets, newest first.
34
+ export async function GET() {
35
+ const col = await tickets();
36
+ const items = await col.find({}).sort({ createdAt: -1 }).toArray();
37
+ return NextResponse.json(items.map(shape));
38
+ }
39
+
40
+ // POST /api/tickets — add a ticket. Body: { subject, requester, status, priority, body }.
41
+ export async function POST(request) {
42
+ const body = await request.json().catch(() => ({}));
43
+ const subject = typeof body.subject === "string" ? body.subject.trim() : "";
44
+ if (!subject) {
45
+ return NextResponse.json({ error: "subject is required" }, { status: 400 });
46
+ }
47
+ const doc = {
48
+ subject,
49
+ requester: typeof body.requester === "string" ? body.requester.trim() : "",
50
+ status: STATUSES.includes(body.status) ? body.status : "open",
51
+ priority: PRIORITIES.includes(body.priority) ? body.priority : "normal",
52
+ body: typeof body.body === "string" ? body.body.trim() : "",
53
+ createdAt: new Date(),
54
+ };
55
+ const col = await tickets();
56
+ const res = await col.insertOne(doc);
57
+ return NextResponse.json({ id: res.insertedId.toString(), ...doc }, { status: 201 });
58
+ }
59
+
60
+ // PATCH /api/tickets — change a ticket's status. Body: { id, status }.
61
+ export async function PATCH(request) {
62
+ const body = await request.json().catch(() => ({}));
63
+ const { id, status } = body;
64
+ if (!id || !ObjectId.isValid(id) || !STATUSES.includes(status)) {
65
+ return NextResponse.json({ error: "valid id and status required" }, { status: 400 });
66
+ }
67
+ const col = await tickets();
68
+ await col.updateOne({ _id: new ObjectId(id) }, { $set: { status } });
69
+ return NextResponse.json({ ok: true });
70
+ }
71
+
72
+ // DELETE /api/tickets?id=<id> — remove a ticket.
73
+ export async function DELETE(request) {
74
+ const id = new URL(request.url).searchParams.get("id");
75
+ if (!id || !ObjectId.isValid(id)) {
76
+ return NextResponse.json({ error: "valid id is required" }, { status: 400 });
77
+ }
78
+ const col = await tickets();
79
+ await col.deleteOne({ _id: new ObjectId(id) });
80
+ return NextResponse.json({ ok: true });
81
+ }
@@ -0,0 +1,36 @@
1
+ // Root layout + plain inline CSS (no external CDNs, fonts, or stylesheets).
2
+ export const metadata = {
3
+ title: "Support tickets",
4
+ description: "A persistent support ticket / helpdesk queue on CloudGrid, backed by grid-shared Mongo.",
5
+ };
6
+
7
+ const css = `
8
+ :root { color-scheme: light dark; }
9
+ * { box-sizing: border-box; }
10
+ body { margin: 0; font-family: system-ui, -apple-system, sans-serif; line-height: 1.5; }
11
+ main { max-width: 60rem; margin: 3rem auto; padding: 0 1.25rem; }
12
+ h1 { margin: 0 0 .25rem; }
13
+ .hint { margin: 0 0 1.5rem; opacity: .7; font-size: .9rem; }
14
+ .row { display: flex; flex-wrap: wrap; gap: .5rem; margin-bottom: 1.5rem; }
15
+ input, select, textarea { padding: .5rem .75rem; border: 1px solid #8886; border-radius: .5rem; font: inherit; }
16
+ input { flex: 1; min-width: 8rem; }
17
+ textarea { width: 100%; min-height: 3rem; resize: vertical; }
18
+ button { padding: .5rem .9rem; border: 1px solid #8886; border-radius: .5rem; background: #6663; font: inherit; cursor: pointer; }
19
+ button:disabled { opacity: .5; cursor: default; }
20
+ table { width: 100%; border-collapse: collapse; }
21
+ th, td { text-align: left; padding: .6rem .5rem; border-bottom: 1px solid #8883; vertical-align: top; }
22
+ th { font-size: .8rem; text-transform: uppercase; letter-spacing: .03em; opacity: .7; }
23
+ .prio { font-size: .75rem; padding: .1rem .45rem; border: 1px solid #8886; border-radius: 1rem; }
24
+ .empty { opacity: .6; }
25
+ `;
26
+
27
+ export default function RootLayout({ children }) {
28
+ return (
29
+ <html lang="en">
30
+ <head>
31
+ <style dangerouslySetInnerHTML={{ __html: css }} />
32
+ </head>
33
+ <body>{children}</body>
34
+ </html>
35
+ );
36
+ }
@@ -0,0 +1,35 @@
1
+ // Home page: a server component reads the tickets straight from Mongo, and a
2
+ // small client component adds / changes status / removes them via the API route.
3
+ // Data persists across refresh and across users because it lives in the
4
+ // grid-shared Mongo, not in memory.
5
+ import { getDb } from "../lib/db.js";
6
+ import TicketQueue from "./ticket-queue.js";
7
+
8
+ export const dynamic = "force-dynamic";
9
+
10
+ const STATUSES = ["open", "pending", "closed"];
11
+ const PRIORITIES = ["low", "normal", "high", "urgent"];
12
+
13
+ async function listTickets() {
14
+ const db = await getDb();
15
+ const items = await db.collection("tickets").find({}).sort({ createdAt: -1 }).toArray();
16
+ return items.map((t) => ({
17
+ id: t._id.toString(),
18
+ subject: t.subject || "",
19
+ requester: t.requester || "",
20
+ status: STATUSES.includes(t.status) ? t.status : "open",
21
+ priority: PRIORITIES.includes(t.priority) ? t.priority : "normal",
22
+ body: t.body || "",
23
+ }));
24
+ }
25
+
26
+ export default async function Page() {
27
+ const tickets = await listTickets();
28
+ return (
29
+ <main>
30
+ <h1>Support tickets</h1>
31
+ <p className="hint">Persisted in the grid-shared Mongo — survives refresh.</p>
32
+ <TicketQueue initialTickets={tickets} />
33
+ </main>
34
+ );
35
+ }
@@ -0,0 +1,112 @@
1
+ "use client";
2
+
3
+ // Small client component: renders the tickets table and posts to /api/tickets.
4
+ import { useState } from "react";
5
+
6
+ const STATUSES = ["open", "pending", "closed"];
7
+ const STATUS_LABELS = { open: "Open", pending: "Pending", closed: "Closed" };
8
+ const PRIORITIES = ["low", "normal", "high", "urgent"];
9
+ const PRIORITY_LABELS = { low: "Low", normal: "Normal", high: "High", urgent: "Urgent" };
10
+
11
+ export default function TicketQueue({ initialTickets }) {
12
+ const [tickets, setTickets] = useState(initialTickets);
13
+ const [subject, setSubject] = useState("");
14
+ const [requester, setRequester] = useState("");
15
+ const [priority, setPriority] = useState("normal");
16
+ const [body, setBody] = useState("");
17
+ const [busy, setBusy] = useState(false);
18
+
19
+ async function add(e) {
20
+ e.preventDefault();
21
+ if (!subject.trim()) return;
22
+ setBusy(true);
23
+ const res = await fetch("/api/tickets", {
24
+ method: "POST",
25
+ headers: { "content-type": "application/json" },
26
+ body: JSON.stringify({ subject, requester, priority, body }),
27
+ });
28
+ if (res.ok) {
29
+ const ticket = await res.json();
30
+ setTickets((prev) => [ticket, ...prev]);
31
+ setSubject("");
32
+ setRequester("");
33
+ setPriority("normal");
34
+ setBody("");
35
+ }
36
+ setBusy(false);
37
+ }
38
+
39
+ async function setStatus(id, status) {
40
+ setBusy(true);
41
+ const res = await fetch("/api/tickets", {
42
+ method: "PATCH",
43
+ headers: { "content-type": "application/json" },
44
+ body: JSON.stringify({ id, status }),
45
+ });
46
+ if (res.ok) setTickets((prev) => prev.map((t) => (t.id === id ? { ...t, status } : t)));
47
+ setBusy(false);
48
+ }
49
+
50
+ async function remove(id) {
51
+ setBusy(true);
52
+ const res = await fetch(`/api/tickets?id=${encodeURIComponent(id)}`, { method: "DELETE" });
53
+ if (res.ok) setTickets((prev) => prev.filter((t) => t.id !== id));
54
+ setBusy(false);
55
+ }
56
+
57
+ return (
58
+ <div>
59
+ <form onSubmit={add}>
60
+ <div className="row">
61
+ <input value={subject} onChange={(e) => setSubject(e.target.value)} placeholder="Subject" aria-label="Subject" />
62
+ <input value={requester} onChange={(e) => setRequester(e.target.value)} placeholder="Requester" aria-label="Requester" />
63
+ <select value={priority} onChange={(e) => setPriority(e.target.value)} aria-label="Priority">
64
+ {PRIORITIES.map((p) => (
65
+ <option key={p} value={p}>{PRIORITY_LABELS[p]}</option>
66
+ ))}
67
+ </select>
68
+ <button type="submit" disabled={busy}>Add</button>
69
+ </div>
70
+ <div className="row">
71
+ <textarea value={body} onChange={(e) => setBody(e.target.value)} placeholder="Describe the issue…" aria-label="Body" />
72
+ </div>
73
+ </form>
74
+ <table>
75
+ <thead>
76
+ <tr>
77
+ <th>Subject</th>
78
+ <th>Requester</th>
79
+ <th>Priority</th>
80
+ <th>Status</th>
81
+ <th></th>
82
+ </tr>
83
+ </thead>
84
+ <tbody>
85
+ {tickets.length === 0 && (
86
+ <tr><td className="empty" colSpan={5}>No tickets yet.</td></tr>
87
+ )}
88
+ {tickets.map((t) => (
89
+ <tr key={t.id}>
90
+ <td>
91
+ <div>{t.subject}</div>
92
+ {t.body && <div className="hint">{t.body}</div>}
93
+ </td>
94
+ <td>{t.requester}</td>
95
+ <td><span className="prio">{PRIORITY_LABELS[t.priority]}</span></td>
96
+ <td>
97
+ <select value={t.status} onChange={(e) => setStatus(t.id, e.target.value)} disabled={busy} aria-label="Status">
98
+ {STATUSES.map((s) => (
99
+ <option key={s} value={s}>{STATUS_LABELS[s]}</option>
100
+ ))}
101
+ </select>
102
+ </td>
103
+ <td>
104
+ <button type="button" onClick={() => remove(t.id)} disabled={busy}>Delete</button>
105
+ </td>
106
+ </tr>
107
+ ))}
108
+ </tbody>
109
+ </table>
110
+ </div>
111
+ );
112
+ }
@@ -0,0 +1,32 @@
1
+ // Cached MongoDB client for the App Router.
2
+ //
3
+ // The grid injects the connection string as the DATABASE_MONGODB_URL environment
4
+ // variable (plus the legacy MONGODB_URL alias) at dev-time (`grid dev`) and
5
+ // runtime (after `grid plug`). Read the canonical var first, fall back to the
6
+ // legacy alias. Never hardcode a connection string here and never commit a secret.
7
+ //
8
+ // The env var and client are resolved LAZILY (inside getDb), never at module top
9
+ // level — otherwise `next build` throws when it imports this module for route
10
+ // analysis, before the grid injects the var.
11
+ import { MongoClient } from "mongodb";
12
+
13
+ function clientPromise() {
14
+ const uri = process.env.DATABASE_MONGODB_URL || process.env.MONGODB_URL;
15
+ if (!uri) {
16
+ throw new Error(
17
+ "DATABASE_MONGODB_URL is not set. The grid injects it automatically — run " +
18
+ "this app with `grid dev` locally, or deploy it with `grid plug` (the grid " +
19
+ "injects the DB connection string at runtime). Do not set it by hand.",
20
+ );
21
+ }
22
+ if (!globalThis.__mongoClientPromise) {
23
+ globalThis.__mongoClientPromise = new MongoClient(uri).connect();
24
+ }
25
+ return globalThis.__mongoClientPromise;
26
+ }
27
+
28
+ export async function getDb() {
29
+ const client = await clientPromise();
30
+ // The default DB comes from the connection-string path segment the grid injects.
31
+ return client.db();
32
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "my-tickets",
3
+ "version": "0.1.0",
4
+ "private": true,
5
+ "scripts": {
6
+ "dev": "next dev",
7
+ "build": "next build",
8
+ "start": "next start"
9
+ },
10
+ "dependencies": {
11
+ "next": "^15.1.0",
12
+ "react": "^19.0.0",
13
+ "react-dom": "^19.0.0",
14
+ "mongodb": "^6.12.0"
15
+ }
16
+ }