nextworks 0.2.0-alpha.2 → 0.2.0-alpha.20

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 (145) hide show
  1. package/README.md +280 -228
  2. package/dist/cli_manifests/blocks_manifest.json +193 -194
  3. package/dist/commands/blocks.d.ts +3 -0
  4. package/dist/commands/blocks.d.ts.map +1 -1
  5. package/dist/commands/blocks.js +128 -19
  6. package/dist/commands/blocks.js.map +1 -1
  7. package/dist/commands/doctor.d.ts +136 -0
  8. package/dist/commands/doctor.d.ts.map +1 -0
  9. package/dist/commands/doctor.js +696 -0
  10. package/dist/commands/doctor.js.map +1 -0
  11. package/dist/commands/remove-blocks.d.ts +4 -1
  12. package/dist/commands/remove-blocks.d.ts.map +1 -1
  13. package/dist/commands/remove-blocks.js +24 -6
  14. package/dist/commands/remove-blocks.js.map +1 -1
  15. package/dist/index.js +125 -4
  16. package/dist/index.js.map +1 -1
  17. package/dist/kits/blocks/.nextworks/docs/BLOCKS_QUICKSTART.md +104 -194
  18. package/dist/kits/blocks/.nextworks/docs/BLOCKS_README.md +115 -75
  19. package/dist/kits/blocks/.nextworks/docs/THEME_GUIDE.md +269 -251
  20. package/dist/kits/blocks/app/templates/digitalagency/PresetThemeVars.tsx +80 -80
  21. package/dist/kits/blocks/app/templates/digitalagency/README.md +42 -36
  22. package/dist/kits/blocks/app/templates/digitalagency/components/About.tsx +71 -99
  23. package/dist/kits/blocks/app/templates/digitalagency/components/CTA.tsx +40 -74
  24. package/dist/kits/blocks/app/templates/digitalagency/components/Contact.tsx +123 -227
  25. package/dist/kits/blocks/app/templates/digitalagency/components/Footer.tsx +89 -89
  26. package/dist/kits/blocks/app/templates/digitalagency/components/Hero.tsx +83 -90
  27. package/dist/kits/blocks/app/templates/digitalagency/components/Navbar.tsx +121 -168
  28. package/dist/kits/blocks/app/templates/digitalagency/components/NetworkPattern.tsx +288 -297
  29. package/dist/kits/blocks/app/templates/digitalagency/components/Portfolio.tsx +157 -157
  30. package/dist/kits/blocks/app/templates/digitalagency/components/Pricing.tsx +114 -114
  31. package/dist/kits/blocks/app/templates/digitalagency/components/Process.tsx +59 -59
  32. package/dist/kits/blocks/app/templates/digitalagency/components/Services.tsx +55 -55
  33. package/dist/kits/blocks/app/templates/digitalagency/components/Team.tsx +28 -28
  34. package/dist/kits/blocks/app/templates/digitalagency/components/Testimonials.tsx +65 -65
  35. package/dist/kits/blocks/app/templates/digitalagency/page.tsx +38 -38
  36. package/dist/kits/blocks/app/templates/gallery/PresetThemeVars.tsx +130 -85
  37. package/dist/kits/blocks/app/templates/gallery/page.tsx +357 -303
  38. package/dist/kits/blocks/app/templates/productlaunch/PresetThemeVars.tsx +75 -74
  39. package/dist/kits/blocks/app/templates/productlaunch/README.md +62 -55
  40. package/dist/kits/blocks/app/templates/productlaunch/components/About.tsx +84 -178
  41. package/dist/kits/blocks/app/templates/productlaunch/components/CTA.tsx +50 -93
  42. package/dist/kits/blocks/app/templates/productlaunch/components/Contact.tsx +231 -231
  43. package/dist/kits/blocks/app/templates/productlaunch/components/FAQ.tsx +86 -93
  44. package/dist/kits/blocks/app/templates/productlaunch/components/Features.tsx +83 -84
  45. package/dist/kits/blocks/app/templates/productlaunch/components/Footer.tsx +132 -132
  46. package/dist/kits/blocks/app/templates/productlaunch/components/Hero.tsx +88 -89
  47. package/dist/kits/blocks/app/templates/productlaunch/components/Navbar.tsx +116 -162
  48. package/dist/kits/blocks/app/templates/productlaunch/components/Pricing.tsx +106 -106
  49. package/dist/kits/blocks/app/templates/productlaunch/components/ProcessTimeline.tsx +110 -110
  50. package/dist/kits/blocks/app/templates/productlaunch/components/ServicesGrid.tsx +68 -68
  51. package/dist/kits/blocks/app/templates/productlaunch/components/Team.tsx +104 -104
  52. package/dist/kits/blocks/app/templates/productlaunch/components/Testimonials.tsx +90 -89
  53. package/dist/kits/blocks/app/templates/productlaunch/components/TrustBadges.tsx +76 -76
  54. package/dist/kits/blocks/app/templates/productlaunch/page.tsx +43 -43
  55. package/dist/kits/blocks/app/templates/saasdashboard/PresetThemeVars.tsx +80 -80
  56. package/dist/kits/blocks/app/templates/saasdashboard/README.md +44 -38
  57. package/dist/kits/blocks/app/templates/saasdashboard/components/Contact.tsx +129 -176
  58. package/dist/kits/blocks/app/templates/saasdashboard/components/Dashboard.tsx +293 -293
  59. package/dist/kits/blocks/app/templates/saasdashboard/components/FAQ.tsx +55 -55
  60. package/dist/kits/blocks/app/templates/saasdashboard/components/Features.tsx +90 -91
  61. package/dist/kits/blocks/app/templates/saasdashboard/components/Footer.tsx +77 -77
  62. package/dist/kits/blocks/app/templates/saasdashboard/components/Hero.tsx +104 -105
  63. package/dist/kits/blocks/app/templates/saasdashboard/components/Hero_mask.tsx +126 -127
  64. package/dist/kits/blocks/app/templates/saasdashboard/components/Navbar.tsx +117 -159
  65. package/dist/kits/blocks/app/templates/saasdashboard/components/Pricing.tsx +90 -90
  66. package/dist/kits/blocks/app/templates/saasdashboard/components/SmoothScroll.tsx +96 -97
  67. package/dist/kits/blocks/app/templates/saasdashboard/components/Testimonials.tsx +72 -72
  68. package/dist/kits/blocks/app/templates/saasdashboard/components/TrustBadges.tsx +53 -53
  69. package/dist/kits/blocks/app/templates/saasdashboard/page.tsx +39 -39
  70. package/dist/kits/blocks/components/enhanced-theme-provider.tsx +195 -183
  71. package/dist/kits/blocks/components/providers/BlocksAppProviders.tsx +27 -27
  72. package/dist/kits/blocks/components/sections/About.tsx +291 -291
  73. package/dist/kits/blocks/components/sections/CTA.tsx +257 -258
  74. package/dist/kits/blocks/components/sections/CommandShowcase.tsx +517 -0
  75. package/dist/kits/blocks/components/sections/Contact.tsx +267 -267
  76. package/dist/kits/blocks/components/sections/FAQ.tsx +214 -225
  77. package/dist/kits/blocks/components/sections/FeaturedProjectShowcase.tsx +687 -0
  78. package/dist/kits/blocks/components/sections/Features.tsx +268 -270
  79. package/dist/kits/blocks/components/sections/Footer.tsx +302 -302
  80. package/dist/kits/blocks/components/sections/HeroMotion.tsx +308 -308
  81. package/dist/kits/blocks/components/sections/HeroOverlay.tsx +358 -358
  82. package/dist/kits/blocks/components/sections/HeroProductDemo.tsx +246 -0
  83. package/dist/kits/blocks/components/sections/HeroSplit.tsx +352 -352
  84. package/dist/kits/blocks/components/sections/HeroWithVideo.tsx +495 -0
  85. package/dist/kits/blocks/components/sections/Navbar.tsx +352 -353
  86. package/dist/kits/blocks/components/sections/PortfolioSimple.tsx +549 -550
  87. package/dist/kits/blocks/components/sections/Pricing.tsx +264 -264
  88. package/dist/kits/blocks/components/sections/ProcessTimeline.tsx +325 -325
  89. package/dist/kits/blocks/components/sections/ProjectDeepDive.tsx +805 -0
  90. package/dist/kits/blocks/components/sections/SelectedWorkRail.tsx +485 -0
  91. package/dist/kits/blocks/components/sections/ServicesGrid.tsx +210 -210
  92. package/dist/kits/blocks/components/sections/Team.tsx +309 -309
  93. package/dist/kits/blocks/components/sections/Testimonials.tsx +158 -158
  94. package/dist/kits/blocks/components/sections/TrustBadges.tsx +162 -162
  95. package/dist/kits/blocks/components/sections/product-demo/ApprovalInboxPanel.tsx +128 -0
  96. package/dist/kits/blocks/components/sections/product-demo/DemoStage.tsx +519 -0
  97. package/dist/kits/blocks/components/sections/product-demo/DemoWindow.tsx +140 -0
  98. package/dist/kits/blocks/components/sections/product-demo/KnowledgePanel.tsx +130 -0
  99. package/dist/kits/blocks/components/sections/product-demo/RunConsolePanel.tsx +430 -0
  100. package/dist/kits/blocks/components/sections/product-demo/TaskListPanel.tsx +302 -0
  101. package/dist/kits/blocks/components/sections/product-demo/WorkflowStudioPanel.tsx +744 -0
  102. package/dist/kits/blocks/components/sections/product-demo/types.ts +262 -0
  103. package/dist/kits/blocks/components/theme-provider.tsx +1 -34
  104. package/dist/kits/blocks/components/ui/alert-dialog.tsx +134 -134
  105. package/dist/kits/blocks/components/ui/brand-node.tsx +121 -121
  106. package/dist/kits/blocks/components/ui/button.tsx +122 -122
  107. package/dist/kits/blocks/components/ui/card.tsx +95 -95
  108. package/dist/kits/blocks/components/ui/checkbox.tsx +30 -30
  109. package/dist/kits/blocks/components/ui/cta-button.tsx +125 -125
  110. package/dist/kits/blocks/components/ui/dropdown-menu.tsx +201 -201
  111. package/dist/kits/blocks/components/ui/feature-card.tsx +91 -91
  112. package/dist/kits/blocks/components/ui/input.tsx +27 -27
  113. package/dist/kits/blocks/components/ui/label.tsx +29 -29
  114. package/dist/kits/blocks/components/ui/pricing-card.tsx +120 -120
  115. package/dist/kits/blocks/components/ui/select.tsx +25 -25
  116. package/dist/kits/blocks/components/ui/skeleton.tsx +13 -13
  117. package/dist/kits/blocks/components/ui/table.tsx +98 -98
  118. package/dist/kits/blocks/components/ui/testimonial-card.tsx +108 -108
  119. package/dist/kits/blocks/components/ui/textarea.tsx +26 -26
  120. package/dist/kits/blocks/components/ui/theme-selector.tsx +243 -247
  121. package/dist/kits/blocks/components/ui/theme-toggle.tsx +74 -74
  122. package/dist/kits/blocks/components/ui/toaster.tsx +7 -7
  123. package/dist/kits/blocks/lib/themes.ts +400 -400
  124. package/dist/kits/blocks/lib/utils.ts +6 -9
  125. package/dist/kits/blocks/package-deps.json +40 -28
  126. package/dist/kits/blocks/tsconfig.json +11 -0
  127. package/dist/kits/blocks/tsconfig.tsbuildinfo +1 -0
  128. package/dist/utils/file-operations.d.ts +3 -1
  129. package/dist/utils/file-operations.d.ts.map +1 -1
  130. package/dist/utils/file-operations.js +84 -12
  131. package/dist/utils/file-operations.js.map +1 -1
  132. package/dist/utils/installation-tracker.d.ts +2 -2
  133. package/dist/utils/installation-tracker.d.ts.map +1 -1
  134. package/dist/utils/installation-tracker.js +11 -11
  135. package/dist/utils/installation-tracker.js.map +1 -1
  136. package/dist/utils/package-manager.d.ts +6 -0
  137. package/dist/utils/package-manager.d.ts.map +1 -0
  138. package/dist/utils/package-manager.js +58 -0
  139. package/dist/utils/package-manager.js.map +1 -0
  140. package/dist/utils/yarn-pnp.d.ts +6 -0
  141. package/dist/utils/yarn-pnp.d.ts.map +1 -0
  142. package/dist/utils/yarn-pnp.js +39 -0
  143. package/dist/utils/yarn-pnp.js.map +1 -0
  144. package/package.json +5 -2
  145. package/dist/kits/blocks/notes/THEME_GUIDE.md +0 -29
package/dist/kits/blocks/.nextworks/docs/BLOCKS_README.md CHANGED
@@ -1,75 +1,115 @@
1
- Blocks kit (cli/kits/blocks)
2
-
3
- This folder contains the files that the CLI copies into a target Next.js project when installing the "blocks" kit.
4
-
5
- What the kit includes
6
-
7
- - UI primitive components (Button, Input, Card, Form primitives, Checkbox, Switch, Toaster)
8
- - Sections and templates (About, CTA, Contact, Hero variants, Navbar, Pricing, Features, etc.)
9
- - Theme and provider utilities (theme-provider, enhanced-theme-provider, lib/themes)
10
- - app/globals.css and placeholder assets used by templates
11
-
12
- Install behavior
13
-
14
- > **Alpha note**
15
- > Other kits (Auth Core, Forms, Data) are currently tested and supported on top of a Blocks install that includes sections and templates. For the smoothest experience, run `npx nextworks@latest add blocks --sections --templates` before adding additional kits.
16
-
17
- - For a full UI kit, run `npx nextworks@latest add blocks --sections --templates` to install **core UI primitives, sections, and templates** so the example templates work out of the box.
18
- - You can pass flags to control what gets installed:
19
- - `npx nextworks@latest add blocks --ui-only` → core UI primitives only (no sections/templates).
20
- - `npx nextworks@latest add blocks --sections` → core + sections only.
21
- - `npx nextworks@latest add blocks --templates` → core + templates only.
22
- - `npx nextworks@latest add blocks --sections --templates` → same as the default (core + sections + templates).
23
-
24
- Files included are defined in `cli/cli_manifests/blocks_manifest.json` in the Nextworks repository. When updating this kit inside the repo, keep that manifest and this kit folder in sync.
25
-
26
- Post-install notes
27
-
28
- 1. Install dependencies copied by the kit (the CLI will merge package-deps.json into your package.json):
29
-
30
- npm install
31
-
32
- 2. Wrap your app with the AppProviders wrapper (the CLI patches this automatically).
33
- - App Router: `app/layout.tsx`
34
- - Pages Router: `pages/_app.tsx`
35
-
36
- Example (App Router):
37
-
38
- // at the top of app/layout.tsx
39
- import "./globals.css"; // optional if you already import it elsewhere in your project
40
- import AppProviders from "@/components/app-providers";
41
-
42
- export default function RootLayout({ children }) {
43
- return (
44
- <html lang="en">
45
- <body>
46
- <AppProviders>
47
- {children}
48
- </AppProviders>
49
- </body>
50
- </html>
51
- );
52
- }
53
-
54
- Notes:
55
- - The kit’s `components/app-providers.*` files are **local kit providers** (they wrap with the kit-local `BlocksAppProviders`), so templates/hooks and providers resolve to the same React context instance under Turbopack/HMR.
56
- - On Pages Router installs, the CLI also ensures kit CSS imports are present in `pages/_app.tsx`:
57
- - `../app/globals.css`
58
- - `../app/tw-animate.css`
59
-
60
- 3. Ensure `app/globals.css` exists in your project and that Tailwind is configured (the Blocks kit expects Tailwind).
61
-
62
- 4. Templates are installed in a router-native location:
63
- - App Router: `app/templates/...`
64
- - Pages Router: `pages/templates/<template>/index.tsx`
65
-
66
- 5. Placeholder assets are located under `public/placeholders`. These should already have been copied by the CLI; if you move files around, keep the paths aligned or update the template image references.
67
-
68
- Publishing notes (for maintainers)
69
-
70
- - This kit is UI-only and has no server/api or prisma files.
71
- - The manifest file `cli/cli_manifests/blocks_manifest.json` is used by the CLI to determine which files to copy when you build and publish the `nextworks` CLI.
72
-
73
- CLI behavior (for maintainers)
74
-
75
- - The CLI copies the files listed in `cli/cli_manifests/blocks_manifest.json`. Keep that manifest and this kit folder in sync when editing the Nextworks repo.
1
+ # Blocks kit
2
+
3
+ This folder is the **Blocks kit** installed by the Nextworks CLI. It’s copied into your Next.js project so you can edit everything locally (shadcn-style): components, sections, templates, and theme utilities.
4
+
5
+ If you’re reading this inside your app repo, you’ll also find companion docs at:
6
+
7
+ - `.nextworks/docs/BLOCKS_QUICKSTART.md` (start here)
8
+ - `.nextworks/docs/THEME_GUIDE.md`
9
+
10
+ ---
11
+
12
+ ## What this adds to your project
13
+
14
+ Depending on install flags, Blocks adds:
15
+
16
+ - **UI primitives** under `components/ui/**` (Button, Input, Card, Select, Checkbox, Switch, Toaster, etc.)
17
+ - **Reusable marketing sections** under `components/sections/**` (Navbar, Hero variants including `HeroWithVideo`, `FeaturedProjectShowcase`, `CommandShowcase`, `ProjectDeepDive`, `SelectedWorkRail`, Features, Pricing, Testimonials, FAQ, Contact, Footer, …)
18
+
19
+ - **Full page templates** under a router-native path (see below)
20
+ - **Theme + provider utilities** under `components/**` and `lib/**`
21
+ - **Global styles**: `app/globals.css` and `app/tw-animate.css`
22
+ - **Placeholder images** under `public/placeholders/**`
23
+
24
+ ---
25
+
26
+
27
+ ## Install commands / options
28
+
29
+ > ```bash
30
+ > npx nextworks@latest add blocks --templates
31
+ > ```
32
+
33
+ Blocks supports these install shapes:
34
+
35
+ - `npx nextworks@latest add blocks --ui-only` → core UI primitives only
36
+ - `npx nextworks@latest add blocks --sections` → core + sections
37
+ - `npx nextworks@latest add blocks --templates` → core + sections + templates (recommended)
38
+
39
+ ---
40
+
41
+ ## After install: what to run
42
+
43
+ 1. Install merged dependencies:
44
+
45
+ ```bash
46
+ npm install
47
+ ```
48
+
49
+ 2. Start dev:
50
+
51
+ ```bash
52
+ npm run dev
53
+ ```
54
+
55
+ 3. Visit template routes (when templates are installed):
56
+ - `/templates/productlaunch`
57
+ - `/templates/saasdashboard`
58
+ - `/templates/digitalagency`
59
+ - `/templates/gallery`
60
+
61
+
62
+ ---
63
+
64
+ ## Where templates live (App Router vs Pages Router)
65
+
66
+ Templates are installed in a router-native location:
67
+
68
+ - **App Router:**
69
+ - `app/templates/<template>/page.tsx`
70
+ - `app/templates/<template>/**`
71
+
72
+ - **Pages Router:**
73
+ - route entry file: `pages/templates/<template>/index.tsx`
74
+ - supporting template files: `components/templates/<template>/**` (kept outside `pages/` so helpers are not treated as routable pages)
75
+
76
+ ---
77
+
78
+ ## Required wiring (providers + CSS)
79
+
80
+ Blocks expects your app to be wrapped in the kit’s local `AppProviders`.
81
+
82
+ - **App Router:** patched in `app/layout.tsx`
83
+ - **Pages Router:** patched in `pages/_app.tsx` (and may create/update `pages/_document.tsx`)
84
+
85
+ The CLI normally patches this automatically.
86
+
87
+ Notes:
88
+
89
+ - Pages Router installs also ensure CSS imports exist in `pages/_app.tsx`:
90
+ - `../app/globals.css`
91
+ - `../app/tw-animate.css`
92
+ - The kit’s `components/app-providers.*` wrappers are **local kit providers** (they wrap the kit-local `BlocksAppProviders`) so providers/hooks resolve to the same React context instance under Turbopack/HMR.
93
+
94
+ ---
95
+
96
+ ## What to edit first
97
+
98
+ - Want to change the look/branding quickly? Start with:
99
+ - `.nextworks/docs/THEME_GUIDE.md`
100
+ - `lib/themes.ts`
101
+ - each template’s `PresetThemeVars` file
102
+
103
+ - Want to customize a section (Navbar/Hero/etc.)?
104
+ - edit files directly under `components/sections/**`
105
+ - for a centered cinematic hero with a video preview, start with `components/sections/HeroWithVideo.tsx`
106
+ - for a deeper flagship project block with tags, feature bullets, CTAs, and media, use `components/sections/FeaturedProjectShowcase.tsx`
107
+ - for a terminal-style command/setup flow, use `components/sections/CommandShowcase.tsx`
108
+ - for a premium visual showcase of templates, launches, or selected projects, use `components/sections/SelectedWorkRail.tsx`
109
+ - for a reusable case-study block covering problem, solution, technical highlights, and result, use `components/sections/ProjectDeepDive.tsx`
110
+
111
+
112
+ - Want to customize a template page?
113
+
114
+ - edit the template route file (see paths above) and its local components.
115
+