darkver8/nav repository overview

⁠Dark's Nav - Minimalist Personal Dashboard & Navigation

Dark's Nav is a modern, lightweight, and privacy-focused personal dashboard built with React and Node.js. The app features a clean and elegant design, smooth interface, and seamless compatibility with desktops, tablets, and mobile devices.

GitHub Repository: https://github.com/qwernot/DarkNav⁠

⁠🌟 Key Features

• 🎨 Modern Aesthetics: Sleek flat design with smooth transitions and a fully functional dark mode.
• 📱 Fully Responsive: Unique two-column layout on mobile devices ensures optimal experience across all screen sizes.
• 🛠️ Powerful Admin Mode: Built-in admin panel (default password: 666333) allows you to:
  • Add, edit, and delete links and categories directly via the UI.
  • Reorder sidebar categories.
  • Change the admin password.
• ☁️ Smart Widgets:
  • Real-Time Weather: Auto-location weather widget with 3-day forecast.
  • Air Quality: Visual air quality index (AQI) indicator.
  • Clock & Date: Elegant analog clock and date display.
• 🚀 Docker-Ready: Packaged as a lightweight Docker image for deployment with a single command or Docker Compose.
• 💾 Persistent Data: All configurations are saved to a local data.json file, making backup and migration extremely simple.
• 🌏 Global Network Optimization: Uses reliable APIs (IP-API, Open-Meteo, Yandex Favicon) for worldwide accessibility, including in China.

⁠📦 Deployment Options

⁠Option 1: Docker Quick Start

Deploy your own instance in seconds with a single command:

1. Create a data file (required for persistence):

echo "{}" > data.json

1. Run the container:

docker run -d \
  -p 3000:3000 \
  -v $(pwd)/data.json:/app/data.json \
  --name darks-nav \
  darkver8/nav

1. Access your dashboard: Open your browser and visit http://localhost:3000⁠.

⁠Option 2: Docker Compose (Recommended)

Use Docker Compose for easier management and auto-restart:

1. Create a docker-compose.yml file with the following content:

version: '3'

services:
  darks-nav:
    image: darkver8/nav
    container_name: darks-nav
    ports:
      - "3000:3000"
    volumes:
      # Map local data.json to container for data persistence
      - ./data.json:/app/data.json
    restart: always

1. Create the required data file:

echo "{}" > data.json

1. Start the service:

docker-compose up -d

1. Access your dashboard: Open your browser and visit http://localhost:3000⁠.

⁠🔧 Configuration

• Admin Password: The default password is 666333. After logging in, you can immediately change it by clicking the "Change Admin Password" button in the sidebar.
• Data Backup: Simply back up the data.json file located on your host machine.

Crafted with ❤️ using React, Vite, Tailwind CSS, and Node.js.

Email:[email protected]⁠ QQ：709275854