IMUII LogoIMUII

Getting Started

Getting Started

Welcome to IMUII — your all-in-one deployment automation tool.

IMUII helps you create, manage, and deploy projects seamlessly inside the IMUII ecosystem.

From initializing a repository to spinning up a live environment — everything happens automatically.

🎯 Choose Your Path

IMUII menyediakan dua cara untuk bekerja dengan platform:

🖥️ CLI Users (Command Line Interface)

Untuk developer yang lebih suka bekerja dari terminal dan ingin otomatisasi penuh.

Kapan menggunakan CLI:
  • Inisialisasi project baru dari template
  • Setup project existing dengan IMUII
  • Otomatisasi Git workflow
  • Integrasi dengan development workflow

🌐 Web Users (Web Dashboard)

Untuk developer yang lebih suka bekerja melalui web interface.

Kapan menggunakan Web:
  • Melihat dan mengelola semua projects
  • Monitor deployment status
  • Upload template custom
  • Mengatur settings project
  • Melihat deployment history

🖥️ Quick Start: CLI Users

⚙️ Prerequisites

Sebelum memulai, pastikan Anda memiliki:

  1. Node.js ≥ 18 terinstall
  2. Git terinstall dan dikonfigurasi
  3. Akun IMUII (login via CLI)
  4. GitHub Authentication (SSH keys atau GitHub CLI)

📋 Step 1: Install IMUII CLI

Terminal 
npm install -g imuii

Atau gunakan tanpa install:

Terminal 
npx imuii init

📋 Step 2: Check Prerequisites

Sebelum inisialisasi, selalu cek prerequisites terlebih dahulu:

Terminal 
imuii check

Command ini akan mengecek:

  • ✅ Status login (apakah sudah login)
  • ✅ Git installation & configuration
  • ✅ GitHub authentication (SSH keys atau GitHub CLI)
  • ✅ Test koneksi aktual ke GitHub
Output jika semua OK: 

✅ Logged in
   Email: user@example.com

✅ GitHub setup complete
   Git user: John Doe
   Connection: Can connect via HTTPS
   SSH keys: 2 found

✅ All prerequisites met

📋 Step 3: Login (Jika Belum)

Terminal 
imuii login

Ini akan membuka browser untuk OAuth flow. Setelah login, token akan tersimpan otomatis.

📋 Step 4: Initialize Project

Terminal 
imuii init

Flow otomatis:
  1. ✅ Prerequisites check (otomatis)
  2. 📦 Project detection (baru atau existing)
  3. 🎨 Template selection (untuk project baru)
  4. ⚙️ Configuration input
  5. 🚀 Project creation (untuk project baru)
  6. 📡 Server registration
  7. 🔧 Git workflow setup
  8. 🔑 GitHub secret setup (opsional)
Output:
  • File imuii.json dengan konfigurasi
  • File .env dengan secret key
  • Git repository ter-setup
  • Project ter-record di server

📋 Step 5: Next Steps

Terminal 
cd my-project
npm install
npm run dev

💡 Tip: Project yang dibuat via CLI otomatis muncul di web dashboard Anda.

🌐 Quick Start: Web Users

⚙️ Prerequisites

Sebelum memulai, pastikan Anda memiliki:

  1. Akun IMUII (daftar/login di web)
  2. GitHub account (untuk import project)

📋 Step 1: Login ke Web Dashboard

  1. Buka [IMUII Web Dashboard](https://imuii.id)
  2. Klik Login di navbar
  3. Login dengan akun Anda

📋 Step 2: Create Project

Ada dua cara untuk membuat project:

#### Opsi A: Import dari GitHub

  1. Klik Create di navbar atau tombol Create Project di dashboard
  2. Pilih tab GitHub
  3. Pilih repository yang ingin di-import
  4. Isi konfigurasi project:
  • Project name
  • Build command
  • Start command
  • Domain (subdomain)
  • Email untuk deployment reports
  1. Klik Create Project

#### Opsi B: Upload Template

  1. Klik Create di navbar
  2. Pilih tab Template
  3. Upload template file atau pilih dari template yang tersedia
  4. Isi konfigurasi project
  5. Klik Create Project

📋 Step 3: Monitor Deployment

Setelah project dibuat:

  1. Project akan muncul di Dashboard atau My Work
  2. Status akan terupdate secara real-time:
  • ⏳ Pending - Menunggu deployment
  • 🔄 Building - Sedang build
  • ✅ Deployed - Sudah deployed
  • ❌ Failed - Deployment gagal
  1. Klik project untuk melihat detail dan logs

📋 Step 4: Manage Projects

Di halaman My Work, Anda dapat:

  • Melihat semua projects
  • Filter berdasarkan status
  • Klik project untuk melihat detail
  • Lihat deployment history
  • Update settings project

🎯 Perbedaan CLI vs Web

FiturCLIWeb
**Inisialisasi Project Baru**✅ Dari template✅ Import dari GitHub / Upload template
**Setup Project Existing**✅ Otomatis✅ Manual import
**Git Workflow**✅ Otomatis setup⚠️ Manual
**Monitor Deployment**⚠️ Via web✅ Real-time di dashboard
**Manage Multiple Projects**⚠️ Via web✅ Semua di satu tempat
**Template Creation**✅ Otomatis dari template✅ Upload custom template
**Settings Management**⚠️ Edit file manual✅ UI interface

🚀 What is IMUII?

IMUII is an internal deployment automation platform built for IM-UII developers.

It eliminates repetitive setup steps by connecting the CLI, backend API, and deploy system into one workflow.

With IMUII, you can:
  • Create a GitHub repo automatically (via CLI)
  • Get a ready-to-deploy configuration file (imuii.json)
  • Build and deploy your app to a live subdomain instantly
  • Monitor all deployments in one dashboard (via Web)
  • Manage multiple projects easily (via Web)

📚 Next Steps

  • CLI Users: Baca [CLI Reference](/docs/cli-reference) untuk command lengkap
  • Web Users: Explore dashboard dan fitur-fitur web interface
  • Semua Users: Pelajari [Deployment Flow](/docs/deployment-flow) untuk memahami proses deployment
💡 Tip: Anda bisa menggunakan CLI dan Web secara bersamaan! CLI untuk setup, Web untuk monitoring dan management.