@africode/core 5.0.10 → 5.0.13
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.
- package/AGENTS.md +585 -585
- package/AGENT_INSTRUCTIONS.md +595 -595
- package/COMPONENT_SCHEMA.json +1826 -1800
- package/LICENSE +623 -623
- package/README.md +476 -476
- package/bin/africode.js +73 -73
- package/bin/cli.ts +82 -82
- package/bin/create-africode.js +220 -220
- package/bin/scaffold.ts +218 -218
- package/components/accordion.js +183 -183
- package/components/alert.js +131 -131
- package/components/auth-form.js +154 -154
- package/components/auth.js +172 -172
- package/components/avatar.js +117 -117
- package/components/badge.js +104 -104
- package/components/base.d.ts +139 -139
- package/components/base.js +234 -234
- package/components/breadcrumb.js +76 -72
- package/components/button.js +164 -164
- package/components/card.js +144 -137
- package/components/carousel.js +32 -32
- package/components/cart-drawer.js +28 -28
- package/components/code-block.js +20 -20
- package/components/contact-form.js +25 -25
- package/components/cookie-consent.js +23 -23
- package/components/cta-banner.js +38 -38
- package/components/cultural-card.js +243 -243
- package/components/dashboard-activity-list.js +103 -103
- package/components/dashboard-card.js +85 -85
- package/components/dashboard-metric.js +81 -81
- package/components/dashboard-shell.js +85 -85
- package/components/dashboard-topbar.js +84 -84
- package/components/divider.js +83 -83
- package/components/dropdown.js +171 -171
- package/components/error-boundary.js +155 -155
- package/components/faq-accordion.js +23 -23
- package/components/feature-grid.js +85 -85
- package/components/file-uploader.js +22 -22
- package/components/filter-bar.js +19 -19
- package/components/footer.js +113 -113
- package/components/form.js +131 -131
- package/components/gallery.js +22 -22
- package/components/hero.js +140 -138
- package/components/icon.js +36 -36
- package/components/index.js +128 -128
- package/components/input.js +252 -256
- package/components/kanga-card.js +185 -185
- package/components/kyc-upload.js +173 -173
- package/components/language-switcher.js +108 -108
- package/components/loader.js +80 -80
- package/components/modal.js +262 -262
- package/components/motion.js +84 -84
- package/components/nav-drawer.js +216 -216
- package/components/navbar.js +243 -236
- package/components/newsletter-signup.js +24 -24
- package/components/pagination.js +31 -31
- package/components/pattern-showcase.js +225 -225
- package/components/pricing-card.js +100 -100
- package/components/product-card.js +41 -41
- package/components/progress.js +132 -134
- package/components/react.js +111 -111
- package/components/search-box.js +24 -24
- package/components/section.js +54 -54
- package/components/select.js +321 -322
- package/components/sidebar.js +180 -180
- package/components/simple-chart.js +22 -22
- package/components/skeleton.js +85 -85
- package/components/stepper.js +28 -28
- package/components/table.js +181 -181
- package/components/tabs.js +202 -202
- package/components/team-grid.js +23 -23
- package/components/testimonial.js +94 -94
- package/components/theme-toggle.js +82 -82
- package/components/toast.js +139 -139
- package/components/tooltip.js +167 -167
- package/components/transaction-ledger.js +138 -138
- package/components/ui-avatar.js +79 -79
- package/components/ui-badge.js +61 -61
- package/components/ui-button.js +149 -149
- package/components/ui-card.js +74 -75
- package/components/ui-chip.js +87 -87
- package/components/ui-input.js +110 -110
- package/components/ui-popover.js +84 -84
- package/components/ui-progress-ring.js +60 -60
- package/components/ui-select.js +85 -85
- package/components/ui-stat.js +75 -75
- package/components/ui-switch.js +85 -85
- package/components/ui-table.js +69 -69
- package/components/ui-tabs.js +99 -99
- package/components/ui-tag.js +64 -64
- package/components/ui-textarea.js +84 -84
- package/components/ui-tooltip.js +66 -66
- package/components/video-player.js +22 -22
- package/components/wallet-balance.js +114 -114
- package/core/a2ui-schema-manager.js +351 -351
- package/core/a2ui.js +696 -696
- package/core/actions.js +27 -27
- package/core/bun-runtime.js +398 -397
- package/core/cli/commands/add.js +23 -23
- package/core/cli/commands/audit.js +58 -58
- package/core/cli/commands/build.js +193 -193
- package/core/cli/commands/create-plugin.js +241 -241
- package/core/cli/commands/dev.js +252 -285
- package/core/cli/commands/lint.js +23 -23
- package/core/cli/commands/test.js +33 -34
- package/core/cli/migrator.js +71 -71
- package/core/cli/ui.js +56 -56
- package/core/compliance.js +823 -823
- package/core/config.js +265 -265
- package/core/db-advanced.js +478 -481
- package/core/db.js +282 -284
- package/core/enhanced-hmr.js +406 -406
- package/core/errors.js +222 -222
- package/core/file-router.js +52 -50
- package/core/hmr-client.js +203 -204
- package/core/hmr.js +205 -197
- package/core/html.d.ts +30 -30
- package/core/html.js +84 -84
- package/core/hydration.js +52 -52
- package/core/lipa-namba-journey.js +548 -605
- package/core/logging.js +14 -14
- package/core/middleware.js +145 -145
- package/core/motion.js +106 -106
- package/core/nida-cig-middleware.js +417 -460
- package/core/patterns.d.ts +124 -124
- package/core/patterns.js +947 -1001
- package/core/plugins/index.js +345 -345
- package/core/request-analytics.js +253 -253
- package/core/request-identity.js +93 -93
- package/core/router.js +386 -386
- package/core/sdk-browser.js +140 -140
- package/core/sdk-client.js +61 -61
- package/core/sdk.d.ts +133 -133
- package/core/sdk.js +148 -148
- package/core/seo.js +76 -76
- package/core/server/auth-endpoints.js +339 -339
- package/core/server/auth.js +180 -180
- package/core/server/csrf.js +200 -206
- package/core/server/db.js +39 -39
- package/core/server/middleware.js +324 -324
- package/core/server/rate-limit.js +238 -238
- package/core/server/render.js +67 -69
- package/core/server/router.js +102 -120
- package/core/session-store.js +68 -68
- package/core/shim.js +28 -28
- package/core/state.d.ts +86 -86
- package/core/state.js +276 -276
- package/core/store.d.ts +122 -122
- package/core/store.js +61 -61
- package/core/validation.d.ts +232 -232
- package/core/validation.js +602 -602
- package/core/websocket.js +656 -641
- package/dist/africode.js +233 -230
- package/dist/africode.js.map +83 -83
- package/dist/build-info.json +3 -3
- package/dist/components.js +195 -192
- package/dist/components.js.map +73 -73
- package/dist/styles/africanity.css +321 -321
- package/dist/styles/typography.css +140 -140
- package/docs/IDE-Guide.md +50 -50
- package/package.json +113 -113
- package/scripts/generate-component-schema.js +82 -79
- package/styles/africanity.css +321 -321
- package/styles/typography.css +140 -140
- package/templates/starter/.env.example +15 -15
- package/templates/starter/africode.config.js +40 -40
- package/templates/starter/package.json +13 -13
- package/templates/starter/src/index.js +18 -18
- package/templates/starter/src/pages/index.html +55 -55
- package/templates/starter/src/pages/index.js +17 -17
- package/templates/starter/src/styles/main.css +3 -3
- package/templates/starter-3d/.env.example +7 -7
- package/templates/starter-3d/africode.config.js +29 -29
- package/templates/starter-3d/components/af-model-viewer.js +125 -125
- package/templates/starter-3d/package.json +14 -14
- package/templates/starter-3d/src/pages/index.html +55 -55
- package/templates/starter-3d/src/pages/index.js +50 -50
- package/templates/starter-3d/src/styles/main.css +3 -3
- package/templates/starter-dashboard/.env.example +21 -21
- package/templates/starter-dashboard/africode.config.js +20 -20
- package/templates/starter-dashboard/package.json +14 -14
- package/templates/starter-dashboard/src/index.js +17 -17
- package/templates/starter-dashboard/src/pages/api/analytics.js +24 -24
- package/templates/starter-dashboard/src/pages/index.html +118 -118
- package/templates/starter-dashboard/src/pages/index.js +110 -110
- package/templates/starter-dashboard/src/styles/main.css +172 -172
- package/templates/starter-fintech/.env.example +28 -28
- package/templates/starter-fintech/africode.config.js +20 -20
- package/templates/starter-fintech/package.json +15 -15
- package/templates/starter-fintech/src/index.js +17 -17
- package/templates/starter-fintech/src/pages/api/auth.js +45 -45
- package/templates/starter-fintech/src/pages/api/dashboard.js +19 -0
- package/templates/starter-fintech/src/pages/api/transfer.js +65 -65
- package/templates/starter-fintech/src/pages/api/wallet.js +39 -39
- package/templates/starter-fintech/src/pages/api/webhooks/payment.js +32 -32
- package/templates/starter-fintech/src/pages/index.html +169 -169
- package/templates/starter-fintech/src/pages/index.js +161 -161
- package/templates/starter-fintech/src/styles/main.css +246 -246
- package/templates/starter-react/.env.example +15 -15
- package/templates/starter-react/africode.config.js +40 -40
- package/templates/starter-react/package.json +15 -15
- package/templates/starter-react/src/pages/index.html +55 -55
- package/templates/starter-react/src/pages/index.js +68 -68
- package/templates/starter-react/src/styles/main.css +3 -3
- package/templates/starter-tailwind/.env.example +15 -15
- package/templates/starter-tailwind/africode.config.js +40 -40
- package/templates/starter-tailwind/package.json +19 -19
- package/templates/starter-tailwind/src/pages/index.html +55 -55
- package/templates/starter-tailwind/src/pages/index.js +67 -67
- package/templates/starter-tailwind/src/styles/main.css +3 -3
- package/templates/starter-tailwind/src/styles/tailwind.css +1 -1
- package/templates/starter-tailwind/src/tailwind-loader.js +30 -30
- package/templates/starter-tailwind/tailwind.config.cjs +18 -18
- package/templates/starter-website/.env.example +18 -18
- package/templates/starter-website/africode.config.js +20 -20
- package/templates/starter-website/package.json +14 -14
- package/templates/starter-website/src/index.js +17 -17
- package/templates/starter-website/src/pages/index.html +124 -124
- package/templates/starter-website/src/pages/index.js +116 -116
- package/templates/starter-website/src/styles/main.css +195 -195
- package/bin/africode.js.1758507140 +0 -343
- package/core/heartbeat.js +0 -64
package/bin/create-africode.js
CHANGED
|
@@ -1,220 +1,220 @@
|
|
|
1
|
-
#!/usr/bin/env bun
|
|
2
|
-
/**
|
|
3
|
-
* create-africode
|
|
4
|
-
*
|
|
5
|
-
* Scaffolds a new AfriCode project by copying the live framework files.
|
|
6
|
-
* usage: bunx create-africode my-app
|
|
7
|
-
*
|
|
8
|
-
* @module bin/create-africode
|
|
9
|
-
*/
|
|
10
|
-
|
|
11
|
-
import { mkdir, writeFile, cp, readFile } from 'fs/promises';
|
|
12
|
-
import { existsSync } from 'fs';
|
|
13
|
-
import path from 'path';
|
|
14
|
-
import { fileURLToPath } from 'url';
|
|
15
|
-
|
|
16
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
17
|
-
const __dirname = path.dirname(__filename);
|
|
18
|
-
const FRAMEWORK_ROOT = path.resolve(__dirname, '..');
|
|
19
|
-
|
|
20
|
-
const colors = {
|
|
21
|
-
green: '\x1b[32m',
|
|
22
|
-
gold: '\x1b[33m',
|
|
23
|
-
blue: '\x1b[34m',
|
|
24
|
-
red: '\x1b[31m',
|
|
25
|
-
reset: '\x1b[0m',
|
|
26
|
-
bold: '\x1b[1m',
|
|
27
|
-
dim: '\x1b[2m'
|
|
28
|
-
};
|
|
29
|
-
|
|
30
|
-
async function resolveTemplateName(args) {
|
|
31
|
-
const templateIdx = args.indexOf('--template');
|
|
32
|
-
if (templateIdx > -1) {
|
|
33
|
-
return args[templateIdx + 1] || 'starter';
|
|
34
|
-
}
|
|
35
|
-
|
|
36
|
-
if (!process.stdin.isTTY || !process.stdout.isTTY || process.env.CI) {
|
|
37
|
-
return 'starter';
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
const options = [
|
|
41
|
-
{ value: 'starter', label: 'starter', description: 'General-purpose starter' },
|
|
42
|
-
{ value: 'starter-fintech', label: 'fintech', description: 'Payments, wallets, and compliance' },
|
|
43
|
-
{ value: 'starter-website', label: 'website', description: 'Marketing and content sites' },
|
|
44
|
-
{ value: 'starter-dashboard', label: 'dashboard', description: 'Admin panels and analytics' },
|
|
45
|
-
{ value: 'starter-tailwind', label: 'tailwind', description: 'Tailwind-enabled starter' },
|
|
46
|
-
{ value: 'starter-react', label: 'react', description: 'React-style starter' },
|
|
47
|
-
{ value: 'starter-3d', label: '3d', description: '3D and immersive starter' }
|
|
48
|
-
];
|
|
49
|
-
|
|
50
|
-
console.log('\nChoose a starter template:');
|
|
51
|
-
options.forEach((option, index) => {
|
|
52
|
-
console.log(` ${index + 1}. ${option.label} - ${option.description}`);
|
|
53
|
-
});
|
|
54
|
-
|
|
55
|
-
process.stdout.write('Enter a number [1-7] (default: 1): ');
|
|
56
|
-
|
|
57
|
-
const answer = await new Promise((resolve) => {
|
|
58
|
-
process.stdin.setEncoding('utf8');
|
|
59
|
-
process.stdin.once('data', (data) => resolve(data.toString().trim()));
|
|
60
|
-
});
|
|
61
|
-
|
|
62
|
-
const selection = Number(answer);
|
|
63
|
-
return options[selection - 1]?.value || 'starter';
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
export async function createProject(targetName) {
|
|
67
|
-
const projectName = targetName || 'africode-app';
|
|
68
|
-
|
|
69
|
-
console.log(`
|
|
70
|
-
${colors.gold}╔═══════════════════════════════════════╗
|
|
71
|
-
║ ${colors.green}Creating AfriCode Project${colors.gold} ║
|
|
72
|
-
╚═══════════════════════════════════════╝${colors.reset}
|
|
73
|
-
`);
|
|
74
|
-
|
|
75
|
-
const projectDir = path.join(process.cwd(), projectName);
|
|
76
|
-
|
|
77
|
-
if (existsSync(projectDir)) {
|
|
78
|
-
console.log(`${colors.red}✗ Directory "${projectName}" already exists${colors.reset}`);
|
|
79
|
-
process.exit(1);
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
console.log(`${colors.dim} Creating ${projectName}...${colors.reset}\n`);
|
|
83
|
-
|
|
84
|
-
try {
|
|
85
|
-
// 1. Create Project Root
|
|
86
|
-
await mkdir(projectDir);
|
|
87
|
-
|
|
88
|
-
// 2. Copy Template Files
|
|
89
|
-
const args = process.argv.slice(2);
|
|
90
|
-
const templateName = await resolveTemplateName(args);
|
|
91
|
-
|
|
92
|
-
//
|
|
93
|
-
|
|
94
|
-
// Map short aliases to full template directory names
|
|
95
|
-
const aliasMap = {
|
|
96
|
-
'3d': 'starter-3d',
|
|
97
|
-
'tailwind': 'starter-tailwind',
|
|
98
|
-
'react': 'starter-react',
|
|
99
|
-
'fintech': 'starter-fintech',
|
|
100
|
-
'website': 'starter-website',
|
|
101
|
-
'dashboard': 'starter-dashboard'
|
|
102
|
-
};
|
|
103
|
-
const actualTemplate = aliasMap[templateName] || templateName || 'starter';
|
|
104
|
-
|
|
105
|
-
const templateDir = path.join(FRAMEWORK_ROOT, 'templates', actualTemplate);
|
|
106
|
-
|
|
107
|
-
if (!existsSync(templateDir)) {
|
|
108
|
-
throw new Error(`Template "${actualTemplate}" not found. Available: starter, tailwind, react, fintech, website, dashboard, 3d`);
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
console.log(`${colors.blue}ℹ Using template: ${actualTemplate}${colors.reset}`);
|
|
112
|
-
|
|
113
|
-
// Recursive copy of the template
|
|
114
|
-
await cp(templateDir, projectDir, { recursive: true });
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
// 3. Package.json is already copied from template
|
|
118
|
-
// We just need to update the name
|
|
119
|
-
const pkgPath = path.join(projectDir, 'package.json');
|
|
120
|
-
const pkgData = await readFile(pkgPath, 'utf8');
|
|
121
|
-
const pkgJson = JSON.parse(pkgData);
|
|
122
|
-
|
|
123
|
-
pkgJson.name = projectName;
|
|
124
|
-
|
|
125
|
-
await writeFile(pkgPath, JSON.stringify(pkgJson, null, 2));
|
|
126
|
-
|
|
127
|
-
// 4. Create bin directory and provide a lightweight CLI wrapper
|
|
128
|
-
// that resolves the installed @africode/core package entrypoint.
|
|
129
|
-
const binDestDir = path.join(projectDir, 'bin');
|
|
130
|
-
await mkdir(binDestDir, { recursive: true });
|
|
131
|
-
|
|
132
|
-
const cliWrapper = `#!/usr/bin/env bun
|
|
133
|
-
import { spawnSync } from 'node:child_process';
|
|
134
|
-
import { existsSync } from 'node:fs';
|
|
135
|
-
import { fileURLToPath } from 'node:url';
|
|
136
|
-
import path from 'node:path';
|
|
137
|
-
|
|
138
|
-
const args = process.argv.slice(2);
|
|
139
|
-
const cliPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../node_modules/@africode/core/bin/africode.js');
|
|
140
|
-
|
|
141
|
-
if (!existsSync(cliPath)) {
|
|
142
|
-
console.error("AfriCode CLI was not found in node_modules. Run 'bun install' first.");
|
|
143
|
-
process.exit(1);
|
|
144
|
-
}
|
|
145
|
-
|
|
146
|
-
const result = spawnSync('bun', [cliPath, ...args], {
|
|
147
|
-
stdio: 'inherit',
|
|
148
|
-
shell: false
|
|
149
|
-
});
|
|
150
|
-
|
|
151
|
-
if (result.error) {
|
|
152
|
-
console.error(result.error);
|
|
153
|
-
process.exit(1);
|
|
154
|
-
}
|
|
155
|
-
|
|
156
|
-
process.exit(result.status ?? 0);
|
|
157
|
-
`;
|
|
158
|
-
|
|
159
|
-
await writeFile(path.join(binDestDir, 'africode.js'), cliWrapper);
|
|
160
|
-
|
|
161
|
-
// 5. Auto-generate index.js if missing
|
|
162
|
-
const srcDir = path.join(projectDir, 'src');
|
|
163
|
-
await mkdir(srcDir, { recursive: true });
|
|
164
|
-
const indexPath = path.join(srcDir, 'index.js');
|
|
165
|
-
if (!existsSync(indexPath)) {
|
|
166
|
-
const indexContent = `/**
|
|
167
|
-
* AfriCode App Entry Point
|
|
168
|
-
*
|
|
169
|
-
* This file exports your app. Modify as needed for your use case:
|
|
170
|
-
* - Server-side rendering: import Layout from core
|
|
171
|
-
* - Static site: export your components here
|
|
172
|
-
* - SPA: import and initialize your router here
|
|
173
|
-
*/
|
|
174
|
-
|
|
175
|
-
import { Layout, html } from '@africode/core';
|
|
176
|
-
|
|
177
|
-
// Example: Simple HTML page export
|
|
178
|
-
export default function App() {
|
|
179
|
-
return Layout({
|
|
180
|
-
title: 'Welcome to AfriCode',
|
|
181
|
-
children: html\`
|
|
182
|
-
<main>
|
|
183
|
-
<h1>Welcome to AfriCode!</h1>
|
|
184
|
-
<p>Your African-centric full-stack framework is ready.</p>
|
|
185
|
-
<p><a href="/components">View Components</a> | <a href="/docs">Read Docs</a></p>
|
|
186
|
-
</main>
|
|
187
|
-
\`
|
|
188
|
-
});
|
|
189
|
-
}
|
|
190
|
-
`;
|
|
191
|
-
await writeFile(indexPath, indexContent);
|
|
192
|
-
console.log(`${colors.blue}ℹ Generated index.js entry point${colors.reset}`);
|
|
193
|
-
}
|
|
194
|
-
|
|
195
|
-
// 6. Success Message
|
|
196
|
-
console.log(`${colors.green}✓ Project created successfully!${colors.reset}\n`);
|
|
197
|
-
console.log(`${colors.bold}Your project contains:${colors.reset}`);
|
|
198
|
-
console.log(` ${colors.blue}africode.config.js${colors.reset} - Framework Configuration`);
|
|
199
|
-
console.log(` ${colors.blue}.env.example${colors.reset} - Environment variable guide`);
|
|
200
|
-
console.log(` ${colors.blue}src/pages/${colors.reset} - File-based routes`);
|
|
201
|
-
console.log(` ${colors.blue}src/styles/${colors.reset} - Theme and design tokens`);
|
|
202
|
-
console.log(` ${colors.blue}src/index.js${colors.reset} - App entry point`);
|
|
203
|
-
console.log(` ${colors.blue}bin/africode.js${colors.reset} - Local CLI wrapper`);
|
|
204
|
-
console.log(`\n${colors.bold}Next steps:${colors.reset}`);
|
|
205
|
-
console.log(` ${colors.dim}cd${colors.reset} ${projectName}`);
|
|
206
|
-
console.log(` ${colors.dim}bun install${colors.reset}`);
|
|
207
|
-
console.log(` ${colors.dim}bun run ./bin/africode.js dev${colors.reset}`);
|
|
208
|
-
console.log(`\n${colors.gold}Happy coding with the rhythm of the continent!${colors.reset}\n`);
|
|
209
|
-
|
|
210
|
-
} catch (err) {
|
|
211
|
-
console.error(`${colors.red}✗ Failed to create project:${colors.reset}`, err);
|
|
212
|
-
process.exit(1);
|
|
213
|
-
}
|
|
214
|
-
}
|
|
215
|
-
|
|
216
|
-
// Allow standalone execution if run directly
|
|
217
|
-
if (import.meta.main) {
|
|
218
|
-
const args = process.argv.slice(2);
|
|
219
|
-
createProject(args[0]);
|
|
220
|
-
}
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
/**
|
|
3
|
+
* create-africode
|
|
4
|
+
*
|
|
5
|
+
* Scaffolds a new AfriCode project by copying the live framework files.
|
|
6
|
+
* usage: bunx create-africode my-app
|
|
7
|
+
*
|
|
8
|
+
* @module bin/create-africode
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { mkdir, writeFile, cp, readFile } from 'fs/promises';
|
|
12
|
+
import { existsSync } from 'fs';
|
|
13
|
+
import path from 'path';
|
|
14
|
+
import { fileURLToPath } from 'url';
|
|
15
|
+
|
|
16
|
+
const __filename = fileURLToPath(import.meta.url);
|
|
17
|
+
const __dirname = path.dirname(__filename);
|
|
18
|
+
const FRAMEWORK_ROOT = path.resolve(__dirname, '..');
|
|
19
|
+
|
|
20
|
+
const colors = {
|
|
21
|
+
green: '\x1b[32m',
|
|
22
|
+
gold: '\x1b[33m',
|
|
23
|
+
blue: '\x1b[34m',
|
|
24
|
+
red: '\x1b[31m',
|
|
25
|
+
reset: '\x1b[0m',
|
|
26
|
+
bold: '\x1b[1m',
|
|
27
|
+
dim: '\x1b[2m'
|
|
28
|
+
};
|
|
29
|
+
|
|
30
|
+
async function resolveTemplateName(args) {
|
|
31
|
+
const templateIdx = args.indexOf('--template');
|
|
32
|
+
if (templateIdx > -1) {
|
|
33
|
+
return args[templateIdx + 1] || 'starter';
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
if (!process.stdin.isTTY || !process.stdout.isTTY || process.env.CI) {
|
|
37
|
+
return 'starter';
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
const options = [
|
|
41
|
+
{ value: 'starter', label: 'starter', description: 'General-purpose starter' },
|
|
42
|
+
{ value: 'starter-fintech', label: 'fintech', description: 'Payments, wallets, and compliance' },
|
|
43
|
+
{ value: 'starter-website', label: 'website', description: 'Marketing and content sites' },
|
|
44
|
+
{ value: 'starter-dashboard', label: 'dashboard', description: 'Admin panels and analytics' },
|
|
45
|
+
{ value: 'starter-tailwind', label: 'tailwind', description: 'Tailwind-enabled starter' },
|
|
46
|
+
{ value: 'starter-react', label: 'react', description: 'React-style starter' },
|
|
47
|
+
{ value: 'starter-3d', label: '3d', description: '3D and immersive starter' }
|
|
48
|
+
];
|
|
49
|
+
|
|
50
|
+
console.log('\nChoose a starter template:');
|
|
51
|
+
options.forEach((option, index) => {
|
|
52
|
+
console.log(` ${index + 1}. ${option.label} - ${option.description}`);
|
|
53
|
+
});
|
|
54
|
+
|
|
55
|
+
process.stdout.write('Enter a number [1-7] (default: 1): ');
|
|
56
|
+
|
|
57
|
+
const answer = await new Promise((resolve) => {
|
|
58
|
+
process.stdin.setEncoding('utf8');
|
|
59
|
+
process.stdin.once('data', (data) => resolve(data.toString().trim()));
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
const selection = Number(answer);
|
|
63
|
+
return options[selection - 1]?.value || 'starter';
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
export async function createProject(targetName) {
|
|
67
|
+
const projectName = targetName || 'africode-app';
|
|
68
|
+
|
|
69
|
+
console.log(`
|
|
70
|
+
${colors.gold}╔═══════════════════════════════════════╗
|
|
71
|
+
║ ${colors.green}Creating AfriCode Project${colors.gold} ║
|
|
72
|
+
╚═══════════════════════════════════════╝${colors.reset}
|
|
73
|
+
`);
|
|
74
|
+
|
|
75
|
+
const projectDir = path.join(process.cwd(), projectName);
|
|
76
|
+
|
|
77
|
+
if (existsSync(projectDir)) {
|
|
78
|
+
console.log(`${colors.red}✗ Directory "${projectName}" already exists${colors.reset}`);
|
|
79
|
+
process.exit(1);
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
console.log(`${colors.dim} Creating ${projectName}...${colors.reset}\n`);
|
|
83
|
+
|
|
84
|
+
try {
|
|
85
|
+
// 1. Create Project Root
|
|
86
|
+
await mkdir(projectDir);
|
|
87
|
+
|
|
88
|
+
// 2. Copy Template Files
|
|
89
|
+
const args = process.argv.slice(2);
|
|
90
|
+
const templateName = await resolveTemplateName(args);
|
|
91
|
+
|
|
92
|
+
// Template validity is enforced by the existsSync(templateDir) check below,
|
|
93
|
+
// which cannot drift out of sync with the templates/ directory.
|
|
94
|
+
// Map short aliases to full template directory names
|
|
95
|
+
const aliasMap = {
|
|
96
|
+
'3d': 'starter-3d',
|
|
97
|
+
'tailwind': 'starter-tailwind',
|
|
98
|
+
'react': 'starter-react',
|
|
99
|
+
'fintech': 'starter-fintech',
|
|
100
|
+
'website': 'starter-website',
|
|
101
|
+
'dashboard': 'starter-dashboard'
|
|
102
|
+
};
|
|
103
|
+
const actualTemplate = aliasMap[templateName] || templateName || 'starter';
|
|
104
|
+
|
|
105
|
+
const templateDir = path.join(FRAMEWORK_ROOT, 'templates', actualTemplate);
|
|
106
|
+
|
|
107
|
+
if (!existsSync(templateDir)) {
|
|
108
|
+
throw new Error(`Template "${actualTemplate}" not found. Available: starter, tailwind, react, fintech, website, dashboard, 3d`);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
console.log(`${colors.blue}ℹ Using template: ${actualTemplate}${colors.reset}`);
|
|
112
|
+
|
|
113
|
+
// Recursive copy of the template
|
|
114
|
+
await cp(templateDir, projectDir, { recursive: true });
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
// 3. Package.json is already copied from template
|
|
118
|
+
// We just need to update the name
|
|
119
|
+
const pkgPath = path.join(projectDir, 'package.json');
|
|
120
|
+
const pkgData = await readFile(pkgPath, 'utf8');
|
|
121
|
+
const pkgJson = JSON.parse(pkgData);
|
|
122
|
+
|
|
123
|
+
pkgJson.name = projectName;
|
|
124
|
+
|
|
125
|
+
await writeFile(pkgPath, JSON.stringify(pkgJson, null, 2));
|
|
126
|
+
|
|
127
|
+
// 4. Create bin directory and provide a lightweight CLI wrapper
|
|
128
|
+
// that resolves the installed @africode/core package entrypoint.
|
|
129
|
+
const binDestDir = path.join(projectDir, 'bin');
|
|
130
|
+
await mkdir(binDestDir, { recursive: true });
|
|
131
|
+
|
|
132
|
+
const cliWrapper = `#!/usr/bin/env bun
|
|
133
|
+
import { spawnSync } from 'node:child_process';
|
|
134
|
+
import { existsSync } from 'node:fs';
|
|
135
|
+
import { fileURLToPath } from 'node:url';
|
|
136
|
+
import path from 'node:path';
|
|
137
|
+
|
|
138
|
+
const args = process.argv.slice(2);
|
|
139
|
+
const cliPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../node_modules/@africode/core/bin/africode.js');
|
|
140
|
+
|
|
141
|
+
if (!existsSync(cliPath)) {
|
|
142
|
+
console.error("AfriCode CLI was not found in node_modules. Run 'bun install' first.");
|
|
143
|
+
process.exit(1);
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
const result = spawnSync('bun', [cliPath, ...args], {
|
|
147
|
+
stdio: 'inherit',
|
|
148
|
+
shell: false
|
|
149
|
+
});
|
|
150
|
+
|
|
151
|
+
if (result.error) {
|
|
152
|
+
console.error(result.error);
|
|
153
|
+
process.exit(1);
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
process.exit(result.status ?? 0);
|
|
157
|
+
`;
|
|
158
|
+
|
|
159
|
+
await writeFile(path.join(binDestDir, 'africode.js'), cliWrapper);
|
|
160
|
+
|
|
161
|
+
// 5. Auto-generate index.js if missing
|
|
162
|
+
const srcDir = path.join(projectDir, 'src');
|
|
163
|
+
await mkdir(srcDir, { recursive: true });
|
|
164
|
+
const indexPath = path.join(srcDir, 'index.js');
|
|
165
|
+
if (!existsSync(indexPath)) {
|
|
166
|
+
const indexContent = `/**
|
|
167
|
+
* AfriCode App Entry Point
|
|
168
|
+
*
|
|
169
|
+
* This file exports your app. Modify as needed for your use case:
|
|
170
|
+
* - Server-side rendering: import Layout from core
|
|
171
|
+
* - Static site: export your components here
|
|
172
|
+
* - SPA: import and initialize your router here
|
|
173
|
+
*/
|
|
174
|
+
|
|
175
|
+
import { Layout, html } from '@africode/core';
|
|
176
|
+
|
|
177
|
+
// Example: Simple HTML page export
|
|
178
|
+
export default function App() {
|
|
179
|
+
return Layout({
|
|
180
|
+
title: 'Welcome to AfriCode',
|
|
181
|
+
children: html\`
|
|
182
|
+
<main>
|
|
183
|
+
<h1>Welcome to AfriCode!</h1>
|
|
184
|
+
<p>Your African-centric full-stack framework is ready.</p>
|
|
185
|
+
<p><a href="/components">View Components</a> | <a href="/docs">Read Docs</a></p>
|
|
186
|
+
</main>
|
|
187
|
+
\`
|
|
188
|
+
});
|
|
189
|
+
}
|
|
190
|
+
`;
|
|
191
|
+
await writeFile(indexPath, indexContent);
|
|
192
|
+
console.log(`${colors.blue}ℹ Generated index.js entry point${colors.reset}`);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
// 6. Success Message
|
|
196
|
+
console.log(`${colors.green}✓ Project created successfully!${colors.reset}\n`);
|
|
197
|
+
console.log(`${colors.bold}Your project contains:${colors.reset}`);
|
|
198
|
+
console.log(` ${colors.blue}africode.config.js${colors.reset} - Framework Configuration`);
|
|
199
|
+
console.log(` ${colors.blue}.env.example${colors.reset} - Environment variable guide`);
|
|
200
|
+
console.log(` ${colors.blue}src/pages/${colors.reset} - File-based routes`);
|
|
201
|
+
console.log(` ${colors.blue}src/styles/${colors.reset} - Theme and design tokens`);
|
|
202
|
+
console.log(` ${colors.blue}src/index.js${colors.reset} - App entry point`);
|
|
203
|
+
console.log(` ${colors.blue}bin/africode.js${colors.reset} - Local CLI wrapper`);
|
|
204
|
+
console.log(`\n${colors.bold}Next steps:${colors.reset}`);
|
|
205
|
+
console.log(` ${colors.dim}cd${colors.reset} ${projectName}`);
|
|
206
|
+
console.log(` ${colors.dim}bun install${colors.reset}`);
|
|
207
|
+
console.log(` ${colors.dim}bun run ./bin/africode.js dev${colors.reset}`);
|
|
208
|
+
console.log(`\n${colors.gold}Happy coding with the rhythm of the continent!${colors.reset}\n`);
|
|
209
|
+
|
|
210
|
+
} catch (err) {
|
|
211
|
+
console.error(`${colors.red}✗ Failed to create project:${colors.reset}`, err);
|
|
212
|
+
process.exit(1);
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
|
|
216
|
+
// Allow standalone execution if run directly
|
|
217
|
+
if (import.meta.main) {
|
|
218
|
+
const args = process.argv.slice(2);
|
|
219
|
+
createProject(args[0]);
|
|
220
|
+
}
|