https://github.com/dmstern/npmfrog

A npmjs.org-like web interface for jFrog Artifactory with material design
https://github.com/dmstern/npmfrog

artifactory jfrog-artifactory material-design npm npmjs package-manager registry rest typescript verdaccio vuejs vuetify

Last synced: 2 months ago
JSON representation

A npmjs.org-like web interface for jFrog Artifactory with material design

• Host: GitHub
• URL: https://github.com/dmstern/npmfrog
• Owner: dmstern
• Created: 2018-07-27T07:07:24.000Z (over 6 years ago)
• Default Branch: develop
• Last Pushed: 2023-11-30T14:36:48.000Z (about 1 year ago)
• Last Synced: 2023-12-18T10:08:41.657Z (about 1 year ago)
• Topics: artifactory, jfrog-artifactory, material-design, npm, npmjs, package-manager, registry, rest, typescript, verdaccio, vuejs, vuetify
• Language: Vue
• Homepage:
• Size: 4.16 MB
• Stars: 3
• Watchers: 3
• Forks: 3
• Open Issues: 19
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# npmFrog

> A nice npmjs.org-like web interface for JFrog Artifactory

To share code in your company or team between different projects and developers, you can use a private npm registry like [Verdaccio](https://verdaccio.org/) or [JFrog's Artifactory](https://www.jfrog.com/confluence/display/RTF/Npm+Registry) (which is often used for Maven dependency management in the Java Environment).

The latter lacks a good UI for web developers, so npmFrog is here to present you the self-hosted packages of your team in a more familiar and discoverable way.

👐 It's free and open source. :)

## Core Features

- _The homepage: an overview list of your company's packages._

  ![Screenshot: package list](art/screenshot-list.png)

- _The awesome package search: lookup tags, crafters and packages._

  ![Screenshot: search](art/screenshot-search.png)

- _Every package has a detail page to view a lot of useful meta information. Even the remote-cache packages._

  ![Screenshot: package detail page](art/screenshot-detail.png)

- _Get details about the people who crafted the package to contact them or to search for other packages by the same author._

  ![Screenshot: crafter info](art/screenshot-crafter.png)

- _Get an overview of all npm scripts in the `package.json`._

  ![Screenshot: scripts](art/screenshot-scripts.png)

- _Inspect files that are contained in the package and view or download its code._

  ![Screenshot: file inspector](art/screenshot-files.png)

## Prerequisites

- [Node.js >= 8.x](https://nodejs.org/en/download/)

- JFrog Artifactory is running somewhere in your company's network

## Installation

```bash

npm i -g npmfrog

```

## Usage

### Start

```bash

npmfrog

```

Browse to npmFrog instance [http://localhost:8000](http://localhost:8000).

### Stop

```bash

npmfrog stop

```

### Show logs

```bash

npmfrog logs

```

### Show status

```bash

npmfrog status

```

### Configuration

At the first startup, npmFrog will create a configuration file in your home directory under `~/.npmfrog/config.json`. Please fill this file with your artifactory properties.

If you want to add additional text in the `/howto` section, you can create a `howto.md` file in the `~/.npmfrog` directory with some additional [markdown](https://www.markdownguide.org/) content.

![Screenshot of additional howto.md in ~/.npmfrog/](art/Screenshot-howto.png)

If you want to hide the default publishing guide under `/howto`, set `howto.default` in the `config.json` file to `false`.

```json

  "howto": {

    "default": false

  }

```

### Development

Run the development task with real back-end data:

```bash

npm run dev

```

With a local environment and dummy data (no internet connection needed):

```bash

npm start

```

To see the logs, run

```bash

npm run logs

```

Stop all running background processes:

```bash

npm stop

```

See the status of background processes:

```bash

npm run ps

```