README.md

Raw / Download

<div align="center">
  <img src="icon.png" alt="Node Runner Icon" width="128" />
  
  # Node Runner for VS Code

  **Execute Node.js scripts effortlessly directly from your editor.**
  
<<<<<<< HEAD
  [![Version](https://img.shields.io/badge/version-0.0.5-blue.svg)](https://xarmina.eu/git/SimpelNodeRunnner#code)
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://xarmina.eu/git/SimpelNodeRunnner#code)
=======
<<<<<<< HEAD
  [![Version](https://img.shields.io/badge/version-0.0.5-blue.svg)](https://xarmina.eu/git/SimpelNodeRunnner#code)
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://xarmina.eu/git/SimpelNodeRunnner#code)
=======
  [![Version](https://img.shields.io/badge/version-0.0.3-blue.svg)](https://rl-dev.de/git/view/NodeRunner)
  [![License](https://img.shields.io/badge/license-MIT-green.svg)](https://rl-dev.de/git/view/NodeRunner)
>>>>>>> e49830b8c9b232a376cfaad5f5dc82137fa84061
>>>>>>> 5efaca5effb718582dc2468513252827fe8da1a5
  [![VS Code](https://img.shields.io/badge/Visual%20Studio%20Code-1.70%2B-blueviolet.svg)](https://code.visualstudio.com/)

</div>

---

**Node Runner** provides a seamless experience for Node.js developers in VS Code. Inspired by the popular Python Runner, it allows you to run, stop, and manage your Node.js scripts and NPM commands without leaving your code.

## ✨ Features

### 🚀 Instant Execution
Run your current JavaScript file (`.js`) instantly with a single click on the **Play** button in the editor title bar. No complex launch configurations required.

### ⏹️ Control Execution
Need to stop a long-running script or server? Simply hit the **Stop** button in the title bar to terminate the process immediately.

### 📦 NPM Command Center
Access your project's `package.json` scripts and essential NPM commands from a dedicated **Activity Bar View**:
- **Scripts:** One-click execution of any script defined in your `package.json`.
- **Quick Actions:**
  - `npm install` - Install dependencies.
  - `npm init` - Initialize a new project.
  - `npm outdated` - Check for outdated packages.
  - `npm audit` - Run security audit.

### 🔄 Node.js Version Check
Stay up-to-date with automatic checks for the latest Node.js LTS version. The extension can notify you if your local version is outdated and provide a direct link to upgrade.

## 📥 Installation

1. Open **VS Code**.
2. Go to the **Extensions** view (`Ctrl+Shift+X`).
3. Search for **"Simple Node.js Runner"**.
4. Click **Install**.

## 🛠️ Usage

### Running a Script
1. Open any `.js` file in the active editor.
2. Click the **Play** icon $(play) in the top-right editor title bar.
3. Output will appear in the **"Node Runner"** output channel.

### Using NPM Commands
1. Click on the **Node Runner** icon in the Activity Bar.
2. Expand the **NPM Commands** view.
3. Click on the **Run** icon $(play-circle) next to any script to execute it.

## 📋 Requirements

- **Node.js**: Must be installed and added to your system's `PATH`.
- **VS Code**: Version 1.70.0 or higher.

## 🤝 Support & Feedback

If you encounter any issues or have suggestions for improvements, please feel free to reach out or report a bug.

- **Developer:** Xarmina Private
- **Website:** [xarmina.eu](https://xarmina.eu/)
- **Email:** [admin@xarmina.eu](mailto:admin@xarmina.eu)
<<<<<<< HEAD
- **Source Code:** [xarmina.eu/git/SimpelNodeRunnner](https://xarmina.eu/git/SimpelNodeRunnner#code)
- **Issue Tracker:** [xarmina.eu/git/SimpelNodeRunnner/issues](https://xarmina.eu/git/SimpelNodeRunnner#issues)
=======
<<<<<<< HEAD
- **Source Code:** [xarmina.eu/git/SimpelNodeRunnner](https://xarmina.eu/git/SimpelNodeRunnner#code)
- **Issue Tracker:** [xarmina.eu/git/SimpelNodeRunnner/issues](https://xarmina.eu/git/SimpelNodeRunnner#issues)
=======
- **Source Code:** [rl-dev.de/git/view/NodeRunner](https://rl-dev.de/git/view/NodeRunner)
- **Issue Tracker:** [rl-dev.de/git/NodeRunner/issues](https://rl-dev.de/git/NodeRunner/issues)
>>>>>>> e49830b8c9b232a376cfaad5f5dc82137fa84061
>>>>>>> 5efaca5effb718582dc2468513252827fe8da1a5

---
<div align="center">
  <sub>Made with ❤️ by Xarmina Private</sub>
</div>