LinkForge

Main Information:

• Project description and purpose
• Main features of the project
• Tech stack
• Libraries

Start guide

⚙️ Requirements

• Node.js v18+
• npm v9+

---

📥 Setup

Clone the repository and install dependencies:

git clone https://github.com/your-username/your-repo.git
cd your-repo
npm run guide

• 👤 User Mode

    Automatic → Launches Backend + Frontend at once
  
    Manual → Choose to start only Backend or Frontend
  

• 💻 Dev Mode

    Launch Backend / Frontend / Both
  
    Run cleanup, reinstall, or npm fixes
  

🛠️ Troubleshooting

The guide automatically detects problems:

If dependencies are missing → runs install-all

If install fails → suggests fix (update npm)

Manual scripts:

npm run clean-all     # Remove all node_modules + locks
npm run install-all   # Reinstall everything
npm run fix           # Update npm

---

📜 Available Scripts

Here’s the full list of scripts you can use:

🎮 Main Scripts

• npm run guide
  Launches the interactive guide (recommended for both Users and Devs).

• npm run launch
  Starts both Backend + Frontend together.

• npm run launch:backend
  Starts Backend only.

• npm run launch:frontend
  Starts Frontend only (port 5555 by default).

---

🧹 Maintenance / Fix Scripts

• npm run clean-all
  Removes all node_modules and lock files (root, backend, frontend).

• npm run install-all
  Installs dependencies for root, backend, and frontend.

• npm run fix
  Updates npm to the latest version (global).