Proposed change to add helpfull scripts to make it easier for folks try the project locally

Author: paul

.gitignore

@@ -0,0 +1,4 @@
+node_modules
+.DS_Store
+.vscode
+.env

copy-env.mts

@@ -0,0 +1,48 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+function copyEnvFile(targetDir: string): void {
+  // Ensure targetDir is trimmed
+  targetDir = targetDir.trim();
+
+  const examplePath: string = path.join(targetDir, ".env.example");
+  const envPath: string = path.join(targetDir, ".env");
+
+  console.log("Attempting to copy from:", examplePath);
+  console.log("To:", envPath);
+  // Check if .env.example exists
+  fs.access(examplePath, fs.constants.F_OK, (err: Error | null) => {
+    if (err) {
+      console.error(`.env.example file does not exist in ${targetDir}`);
+      return;
+    }
+
+    // .env.example exists, now check for .env
+    fs.access(envPath, fs.constants.F_OK, (err: Error | null) => {
+      if (err) {
+        // .env file does not exist, copy .env.example to .env
+        fs.copyFile(examplePath, envPath, (err: Error | null) => {
+          if (err) {
+            console.error("Error occurred:", err);
+            return;
+          }
+          console.log(`.env.example has been copied to ${envPath}`);
+        });
+      } else {
+        // .env file exists, no action needed
+        console.log(
+          `.env file already exists in ${targetDir}, no action taken.`
+        );
+      }
+    });
+  });
+}
+
+// Get the directory path from the command line argument and trim whitespace
+const directoryPath: string | undefined = process.argv[2]?.trim();
+
+if (directoryPath) {
+  copyEnvFile(directoryPath);
+} else {
+  console.error("Please provide a directory path as an argument.");
+}

next/.env.sample renamed to next/.env.example

@@ -1,5 +1,5 @@
 WEBSITE_URL=http://localhost:3000 # Add the correct ENV var for this onto your hosting platform, point it to your production website.
 PORT=3000
 
-NEXT_PUBLIC_API_URL=url-of-strapi
+NEXT_PUBLIC_API_URL=http://localhost:1337
 PREVIEW_SECRET=the-same-random-token-as-for-strapi

package.json

@@ -0,0 +1,26 @@
+{
+  "name": "strapi-next-launchpad-example",
+  "version": "1.0.0",
+  "description": "Next.js Launchpad Example powered by Strapi",
+  "type": "module",
+  "scripts": {
+    "next": "yarn dev --prefix ../next/",
+    "strapi": "yarn dev --prefix ../strapi/",
+    "setup:next": "cd next && yarn && node --loader ts-node/esm ../copy-env.mts ./",
+    "setup:strapi": "cd strapi && yarn && node --loader ts-node/esm ../copy-env.mts ./",
+    "setup": "yarn install && yarn setup:next && yarn setup:strapi",
+    "dev": "yarn concurrently \"cd strapi && yarn develop\" \"npx wait-on http://localhost:1337 && cd next && yarn dev\"",
+    "seed": "cd strapi && yarn strapi import -f ./data/export_20250116105447.tar.gz --force",
+    "export": "cd strapi && yarn strapi export --no-encrypt -f ./data/export_20250116105447",
+    "repo:upstream": "git fetch upstream && git merge upstream/main"
+  },
+  "dependencies": {
+    "@types/node": "^22.5.2",
+    "concurrently": "^8.2.2",
+    "typescript": "^5.0.0",
+    "wait-on": "^8.0.1"
+  },
+  "devDependencies": {
+    "ts-node": "^10.9.2"
+  }
+}

strapi/.env.example

@@ -6,7 +6,7 @@ ADMIN_JWT_SECRET=tobemodified
 TRANSFER_TOKEN_SALT=tobemodified
 JWT_SECRET=tobemodified
 
-STRAPI_ADMIN_CLIENT_URL=url-of-nextjs
+STRAPI_ADMIN_CLIENT_URL=http://localhost:3000
 STRAPI_ADMIN_CLIENT_PREVIEW_SECRET=a-random-token
 
 CLIENT_URL=http://localhost:3000

strapi/data/export_20250116105447.tar.gz

@@ -36,7 +36,7 @@
     "name": "A Strapi developer"
   },
   "strapi": {
-    "uuid": "LAUNCHPAD"
+    "uuid": "LAUNCHPAD-LOCAL-17cde2ab-67bc-4db4-ba40-736eb124ebc1"
   },
   "engines": {
     "node": ">=18.0.0 <=20.x.x",