ZhinNX itu apa? (30 detik)

ZhinNX adalah alat build (sekelas Vite), bukan pengganti React.

Kamu menulis React/Vue/Svelte/TypeScript seperti biasa. ZhinNX yang:

1. Menjalankan dev server + HMR saat coding
2. Build production (minify, split, compress)
3. Opsional NXShield — proteksi client (jujur: penangkal, bukan jaminan)
4. Opsional PWA + force fullscreen — web terasa app, fullscreen semua halaman tanpa tombol

Semua diatur di satu file mirip Vite: zhinnx.config.ts.

Quick start

npm create zhinnx@latest my-app -- --template react-ts
cd my-app
npm install
npm run dev

  ZhinNX v1.0.0  ready in … ms
  ➜  Local:    http://localhost:5273/
  ➜  NXShield: off
  ➜  PWA:      off

Templates: react-ts · vue-ts · svelte-ts · solid-ts · preact-ts · lit-ts · vanilla-ts

Nyalakan fitur unggulan

// zhinnx.config.ts
import { defineConfig } from 'zhinnx'

export default defineConfig({
  // Proteksi client (opt-in)
  shield: {
    enabled: true,
    hardening: { obfuscate: 'light' },
  },

  // Installable + fullscreen semua page
  pwa: {
    enabled: true,
    forceFullscreen: true,
    lockFullscreen: true,
    manifest: {
      name: 'My App',
      shortName: 'App',
      themeColor: '#C8102E',
      backgroundColor: '#0B1020',
      startUrl: '/',
      scope: '/',
    },
  },
})

| Fitur | Cara aktif | Doc | | --- | --- | --- | | NXShield | shield.enabled: true atau zhinnx shield init | docs/features/nxshield.md | | PWA + fullscreen | pwa.enabled + forceFullscreen | docs/features/pwa.md | | Semua opsi config | zhinnx.config.ts / .json | docs/config/overview.md |

NXShield — jujur

• Deterrent, bukan jaminan.
• Tidak menyembunyikan Network tab.
• Secret & auth tetap di server.

CLI

| Perintah | Fungsi | | --- | --- | | zhinnx create | Scaffold project | | zhinnx dev | Dev server + HMR | | zhinnx build | Production → dist/ | | zhinnx preview | Sajikan dist/ | | zhinnx analyze | Laporan ukuran bundle | | zhinnx shield init | Wizard NXShield | | zhinnx doctor | Diagnosa setup | | zhinnx plugin … | Bantu kelola plugin |

Flags: --port --host --open --mode --config --base --outDir --logLevel

Selengkapnya: docs/guide/cli.md

Dokumentasi (untuk pemula → mahir)

Mulai di sini → docs/README.md (peta lengkap)

| Jalur | Link | | --- | --- | | Penjelasan awam | Apa itu ZhinNX? | | Install step-by-step | Getting started | | Struktur folder | Project structure | | Tutorial 1 | Aplikasi pertama | | Tutorial 2 | Shield + PWA fullscreen | | Tutorial 3 | Config → deploy | | Tutorial 4 | Assets & public | | Katalog fitur | All features | | Cara kerja | How it works | | FAQ / istilah | FAQ · Glossary | | Error umum | Troubleshooting |

Monorepo (kontributor)

packages/core          engine + CLI
packages/create-zhinnx scaffold
packages/plugin-*      react vue svelte pwa shield …
templates/             starter user
docs/                  dokumentasi penuh
assets/zhinnx-icon.png logo

git clone https://github.com/zhinnx/zhinnx.git
cd zhinnx && pnpm install && pnpm -r build

License

MIT · © zhinnx