create-java-fullstack

A Node.js CLI that scaffolds a fullstack project with:

• backend/ -> Spring Boot (Maven)
• frontend/ -> React (Create React App)

It behaves similarly to Django's startproject style command.

Installation (local development)

1. Install dependencies for this CLI package (none currently, but command is standard):
   • npm install
2. Link globally:
   • npm link

Then run from anywhere:

• create-java-fullstack my-app

Usage

create-java-fullstack <project-name>

Example:

create-java-fullstack demo-fullstack

Generated structure:

<project-name>/
  backend/
  frontend/

What it generates

Backend

• Downloads Spring Boot Maven project from https://start.spring.io
• Includes dependency: spring-boot-starter-web
• Package: com.example.project
• Creates layered package folders:
  • controller, service, repository, model, dto, config, exception
• Adds:
  • ProjectApplication.java
  • ApiController.java with GET /api returning Hello from Backend

Frontend

• Creates React app in frontend/ via create-react-app
• Auto installs frontend dependencies (CRA default behavior)
• Replaces src/App.js with a sample fetch call to backend /api

Notes

• Ensure you have:
  • Node.js + npm
  • Java + Maven (for running backend later)
• On Linux/macOS, if needed:
  • chmod +x index.js

Run generated apps

Backend

cd <project-name>/backend
mvn spring-boot:run

Frontend

cd <project-name>/frontend
npm start

The frontend sample calls http://localhost:8080/api.

If backend connectivity fails in non-proxy setups, set an explicit backend URL before starting frontend:

# Linux/macOS
export REACT_APP_BACKEND_URL=http://localhost:8080

# Windows PowerShell
$env:REACT_APP_BACKEND_URL = "http://localhost:8080"