Skip to content

piphase/komari-nexus

 
 

Repository files navigation

Komari Nexus

Komari Nexus is a customized Komari theme based on KomariNext, focused on clearer global presentation and practical dashboard-side utilities.

中文说明

Repository

Project Overview

Komari Nexus keeps the solid KomariNext foundation, but reshapes the theme around a more visual and utility-oriented experience.

This version is primarily aimed at users who want:

  • a clearer global view of node distribution
  • a practical way to estimate remaining node value
  • lightweight visitor-side information directly on the page

Based On KomariNext

Komari Nexus is a secondary development project built on top of KomariNext.

The upstream project provides the baseline Komari theme capabilities and overall technical foundation. This repository keeps that attribution explicit and continues to respect the original upstream project and license.

What Komari Nexus Adds

Global Distribution Module

Komari Nexus adds a dedicated global distribution view that lets users understand node placement at a glance.

Highlights:

  • world map based node distribution
  • country and region highlighting
  • region-side node list for the selected area
  • support for opening the existing node detail drawer from map-side interactions

Komari Nexus Global Distribution

Remaining Value Calculator

Komari Nexus adds a remaining value calculator designed for practical day-to-day use.

Highlights:

  • floating entry plus page-side entry button
  • remaining value calculation for nodes with price and billing data
  • default CNY display with exchange-rate conversion
  • filtering between included, skipped, and expired nodes

Komari Nexus Remaining Value Calculator

Visitor Information Floating Card

Komari Nexus adds a visitor information floating card in the lower-left corner of the page.

Highlights:

  • visitor IP and basic geographic/network information
  • delayed presentation after data is ready
  • automatic collapse after display
  • compact reopen button after auto-hide

Komari Nexus Visitor Information Card

Original KomariNext Features

For the baseline theme features inherited from the upstream project, please refer to:

KomariNext

This repository focuses on the custom additions and presentation direction specific to Komari Nexus, rather than duplicating the full upstream feature list.

Installation / Usage

The recommended way to use Komari Nexus is:

  1. Download the packaged theme from Releases
  2. Upload the theme package through the Komari admin dashboard

If you prefer local development or manual packaging, you can build it yourself as described below.

Development

Install dependencies:

npm install

Run the development server:

npm run dev

Build the static theme output:

npm run build

When packaging the theme for Komari, make sure:

  • komari-theme.json is at the root of the zip
  • preview.png is at the root of the zip
  • built site files are placed under dist/

Acknowledgement And License

Komari Nexus is independently maintained, but it is based on the original KomariNext project.

Please keep upstream attribution and licensing information intact when redistributing or modifying this project.

About

Komari-Next is a modern frontend for the Komari monitoring project. It is built with Next.js, TypeScript, Tailwind CSS and Shadcn UI and packaged as a static site that can be used as a Komari theme.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 93.7%
  • CSS 3.6%
  • JavaScript 1.5%
  • Other 1.2%