abw-react-starter 1.0.2 → 1.0.4

package/README.md

@@ -87,6 +87,7 @@ If enabled, the CLI will:
 
   * `plugins.ts`
   * `middlewares.ts`
+  * `server.ts`
 * Ask for:
 
   * Bucket name
@@ -96,6 +97,94 @@ If enabled, the CLI will:
 
 ---
 
+## ⚠️ S3 Bucket Configuration (IMPORTANT)
+
+For image uploads to work correctly, your S3 bucket **must allow public read access**.
+
+---
+
+### 1. Block Public Access
+
+Go to:
+
+S3 → Your Bucket → Permissions → Block public access
+
+Configure:
+
+* ❌ Do NOT block all public access
+* ✔ Allow public access (at least partially)
+
+If everything is blocked, images **will not load in the browser**.
+
+---
+
+### 2. Object Ownership (ACLs)
+
+Go to:
+
+S3 → Your Bucket → Permissions → Object Ownership
+
+Set:
+
+* ✔ ACLs enabled
+
+This is required because Strapi uploads files using:
+
+```js
+ACL: 'public-read'
+```
+
+---
+
+## 🔓 What this means
+
+* Uploaded images will be publicly accessible via URL:
+
+```
+https://your-bucket.s3.region.amazonaws.com/image.jpg
+```
+
+* Only your backend (using AWS credentials) can:
+
+  * upload
+  * delete
+  * modify files
+
+---
+
+## 🔐 Is this secure?
+
+Yes — this is standard practice for most web apps.
+
+As long as you:
+
+* ❌ do NOT expose your AWS credentials
+* ✔ use restricted IAM permissions
+
+your setup is safe.
+
+---
+
+## 🚀 Advanced (optional)
+
+For more advanced setups, you can later switch to:
+
+* CloudFront (CDN)
+* Private buckets + signed URLs
+* Bucket policies instead of ACLs
+
+---
+
+## 🧠 Summary
+
+| Setting                 | Value               |
+| ----------------------- | ------------------- |
+| Block Public Access     | ❌ Not fully blocked |
+| Object Ownership (ACLs) | ✔ Enabled           |
+| Upload ACL              | public-read         |
+
+---
+
 ## 🔐 Requirements
 
 Make sure you have installed:
@@ -129,8 +218,8 @@ npm run dev
 
 ```
 my-app/
-├── backend/     # Strapi API
-├── frontend/    # Next.js app
+├── backend/
+├── frontend/
 └── .abw-starter.json
 ```
 
@@ -164,6 +253,16 @@ The CLI will prompt you to login automatically.
 
 ---
 
+### Images not loading (S3)
+
+Check:
+
+* Bucket is not fully blocking public access
+* ACLs are enabled
+* Correct bucket name and region
+
+---
+
 ## 📄 License
 
 MIT

package/bin/create.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { Command } from "commander";
 import inquirer from "inquirer";
@@ -187,8 +187,20 @@ async function mergeEnvFile(filePath, values) {
   await fs.writeFile(filePath, content);
 }
 
+async function commitAllIfNeeded(cwd, message) {
+  await run("git", ["add", "."], { cwd });
+
+  const status = await runCapture("git", ["status", "--porcelain"], { cwd });
+  if (!status) {
+    console.log("ℹ️ Nada novo para commitar");
+    return;
+  }
+
+  await run("git", ["commit", "-m", message], { cwd });
+}
+
 /* =========================
-   Heroku Login (melhorado)
+   Heroku Login
 ========================= */
 
 async function isHerokuLoggedIn() {
@@ -263,7 +275,7 @@ async function initGitRepo(cwd, message) {
 }
 
 /* =========================
-   🆕 S3 Setup
+   S3 Setup
 ========================= */
 
 async function configureBackendS3(projectDir, aws) {
@@ -395,6 +407,7 @@ async function createBackendLocal(projectDir) {
     cwd: path.join(projectDir, "backend"),
   });
 
+  console.log("\n=== BACKEND: git init/commit ===\n");
   await initGitRepo(path.join(projectDir, "backend"), "Init Strapi backend");
 }
 
@@ -451,6 +464,7 @@ module.exports = nextConfig;
     await fs.writeFile(envLocalPath, "NEXT_PUBLIC_STRAPI_URL=http://localhost:1337\n");
   }
 
+  console.log("\n=== FRONTEND: git init/commit ===\n");
   await initGitRepo(feDir, "Init Next frontend");
 }
 
@@ -518,6 +532,9 @@ async function deployBackendHeroku({ projectDir, backendApp, region }) {
     }
   }
 
+  console.log("\n=== BACKEND: garantir commit antes do deploy ===\n");
+  await commitAllIfNeeded(beDir, "Pre-deploy commit");
+
   console.log("\n=== BACKEND: deploy ===\n");
   await run("git", ["push", "heroku", "main"], { cwd: beDir });
 
@@ -555,6 +572,9 @@ async function deployFrontendHeroku({ projectDir, frontendApp, region, backendWe
     cwd: feDir,
   });
 
+  console.log("\n=== FRONTEND: garantir commit antes do deploy ===\n");
+  await commitAllIfNeeded(feDir, "Pre-deploy commit");
+
   console.log("\n=== FRONTEND: deploy ===\n");
   await run("git", ["push", "heroku", "main"], { cwd: feDir });
 
@@ -622,6 +642,9 @@ async function doCreate(projectDirArg, opts) {
 
   if (useS3 && aws) {
     await configureBackendS3(projectDir, aws);
+
+    console.log("\n=== BACKEND: commit configs S3 ===\n");
+    await commitAllIfNeeded(path.join(projectDir, "backend"), "Configure S3 upload");
   }
 
   await createFrontendLocal(projectDir, nodeVersion);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "abw-react-starter",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "CLI para criar projetos Strapi + Next + Heroku",
   "bin": {
     "abw-react-starter": "./bin/create.js"