Sebelum mulai menggunakan Sitemas, pastikan komputer Anda sudah dilengkapi dengan beberapa tools penting. Artikel ini akan memandu Anda menyiapkan environment development yang optimal untuk menjalankan dan mengembangkan blog Sitemas.
Ringkasan Persyaratan
Berikut adalah persyaratan minimum dan yang direkomendasikan untuk menjalankan Sitemas:
| Komponen | Minimum | Direkomendasikan |
|---|---|---|
| Node.js | v18.17.0 | v20 LTS atau lebih baru |
| npm | v9.0.0 | v10 atau lebih baru |
| Git | v2.30 | v2.40 atau lebih baru |
| Code Editor | Notepad++ | VS Code dengan ekstensi |
| RAM | 4 GB | 8 GB atau lebih |
| Storage | 500 MB | 1 GB (untuk node_modules) |
| OS | Windows 10, macOS 10.15, Ubuntu 20.04 | Versi terbaru |
Astro 6 memanfaatkan fitur JavaScript modern yang hanya tersedia di Node.js versi terbaru. Menggunakan versi yang direkomendasikan memastikan performa terbaik dan kompatibilitas penuh.
1. Node.js dan npm
Node.js adalah runtime JavaScript yang diperlukan untuk menjalankan Astro dan semua tools development modern. npm (Node Package Manager) akan terinstal otomatis bersama Node.js.
Mengecek Instalasi yang Ada
Buka terminal (Command Prompt, PowerShell, atau Terminal) dan jalankan:
Jika muncul nomor versi (contoh: v20.10.0 dan 10.2.3), berarti sudah terinstal. Jika muncul error “command not found”, Anda perlu menginstalnya.
Instalasi Node.js
Cara 1: Download Langsung
- Kunjungi nodejs.org
- Download versi LTS (Long Term Support)
- Jalankan installer dan ikuti wizard
- Restart terminal setelah instalasi
Cara 2: Menggunakan winget (Windows 11)
winget install OpenJS.NodeJS.LTSCara 1: Menggunakan Homebrew (Direkomendasikan)
# Install Homebrew jika belum ada
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install Node.js
brew install nodeCara 2: Download dari Website
Download installer .pkg dari nodejs.org
Menggunakan NodeSource Repository (Ubuntu/Debian)
# Download dan jalankan setup script
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
# Install Node.js
sudo apt-get install -y nodejsMenggunakan nvm (Semua Distro)
# Install nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
# Restart terminal, lalu install Node
nvm install 20
nvm use 20Verifikasi Instalasi
Setelah instalasi selesai, verifikasi dengan menjalankan:
nvm (Node Version Manager) sangat direkomendasikan karena memungkinkan Anda menginstal dan beralih antar versi Node.js dengan mudah. Ini berguna jika Anda bekerja dengan multiple proyek yang membutuhkan versi Node berbeda.
2. Git
Git adalah sistem version control yang digunakan untuk mengelola source code. Anda memerlukan Git untuk meng-clone repository Sitemas dan mengelola perubahan.
Mengecek Instalasi Git
Instalasi Git
Cara 1: Download dari Website
- Kunjungi git-scm.com
- Download installer untuk Windows
- Jalankan installer, gunakan opsi default
- Pilih “Git Bash” sebagai terminal (opsional)
Cara 2: Menggunakan winget
winget install Git.GitGit biasanya sudah terinstal di macOS. Jika belum:
Menggunakan Xcode Command Line Tools
xcode-select --installMenggunakan Homebrew
brew install gitUbuntu/Debian:
sudo apt update
sudo apt install gitFedora:
sudo dnf install gitArch Linux:
sudo pacman -S gitKonfigurasi Git (Pertama Kali)
Setelah instalasi, konfigurasikan identitas Anda:
Konfigurasi ini diperlukan untuk mencatat siapa yang membuat perubahan pada repository.
3. Code Editor
Meskipun Anda bisa menggunakan editor teks apapun, Visual Studio Code (VS Code) sangat direkomendasikan untuk development Sitemas karena dukungan ekstensi yang luar biasa.
Instalasi VS Code
Download dari code.visualstudio.com dan install sesuai sistem operasi Anda.
Ekstensi yang Direkomendasikan
Setelah menginstal VS Code, tambahkan ekstensi berikut untuk pengalaman terbaik:
| Ekstensi | Fungsi |
|---|---|
| Astro | Syntax highlighting dan IntelliSense untuk file .astro |
| MDX | Support untuk file MDX |
| Prettier | Auto-formatting code |
| CSS Peek | Navigasi cepat ke definisi CSS |
| Error Lens | Menampilkan error inline |
| GitLens | Enhanced Git capabilities |
Untuk menginstal ekstensi, buka VS Code, tekan Ctrl+Shift+X (atau Cmd+Shift+X di Mac), dan cari nama ekstensi.
Sitemas sudah menyertakan file .vscode/extensions.json yang akan otomatis merekomendasikan ekstensi yang diperlukan saat Anda membuka proyek.
4. Terminal
Terminal adalah interface command-line untuk menjalankan perintah. Setiap OS memiliki terminal bawaan:
| OS | Terminal Bawaan | Alternatif |
|---|---|---|
| Windows | Command Prompt, PowerShell | Windows Terminal, Git Bash |
| macOS | Terminal.app | iTerm2 |
| Linux | GNOME Terminal, Konsole | Alacritty, Kitty |
Windows Terminal (tersedia di Microsoft Store) sangat direkomendasikan untuk pengguna Windows karena mendukung multiple tabs dan kustomisasi.
5. Browser Modern
Untuk development dan testing, gunakan browser modern dengan DevTools yang baik:
- Google Chrome — DevTools paling lengkap
- Mozilla Firefox — Alternatif dengan fitur developer yang kuat
- Microsoft Edge — Berbasis Chromium, terintegrasi dengan Windows
Browser ini diperlukan untuk:
- Preview website saat development
- Debugging dengan DevTools
- Testing responsive design
- Lighthouse audit untuk performa
Verifikasi Semua Persyaratan
Jalankan skrip berikut untuk memverifikasi semua tools terinstal dengan benar:
Jika semua perintah menampilkan versi tanpa error, Anda siap untuk melanjutkan ke instalasi Sitemas.
Rekomendasi Spesifikasi Hardware
Meskipun Sitemas bisa berjalan di komputer dengan spesifikasi rendah, berikut rekomendasi untuk experience yang optimal:
| Komponen | Minimum | Optimal |
|---|---|---|
| Processor | Dual-core | Quad-core atau lebih |
| RAM | 4 GB | 8-16 GB |
| Storage | HDD 500 MB | SSD 1 GB+ |
| Internet | 1 Mbps | 10 Mbps+ (untuk npm install) |
SSD sangat disarankan karena operasi npm install melibatkan banyak file kecil yang akan sangat lambat di HDD.
Troubleshooting Umum
Node.js tidak terdeteksi setelah instalasi
Windows: Restart komputer atau buka terminal baru. PATH environment variable perlu di-refresh.
macOS/Linux: Jalankan source ~/.bashrc atau source ~/.zshrc tergantung shell yang digunakan.
Permission denied saat npm install (Linux/macOS)
Jangan gunakan sudo npm install. Sebagai gantinya, fix permission npm:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrcGit: SSL certificate problem
Ini biasanya terjadi di jaringan perusahaan dengan proxy. Hubungi IT administrator atau gunakan:
git config --global http.sslVerify false(Hanya untuk troubleshooting, aktifkan kembali setelah selesai)
Langkah Selanjutnya
Setelah semua persyaratan terpenuhi, Anda siap untuk menginstal Sitemas:
Mulai Instalasi
Ikuti panduan step-by-step untuk menginstal dan menjalankan Sitemas di komputer Anda.
Kesimpulan
Menyiapkan environment development yang benar adalah langkah pertama yang penting. Dengan Node.js, Git, VS Code, dan terminal yang sudah dikonfigurasi, Anda memiliki fondasi yang solid untuk mengembangkan blog dengan Sitemas.
Jangan khawatir jika ini terasa overwhelming — sebagian besar tools hanya perlu diinstal sekali dan akan berguna untuk banyak proyek web development lainnya di masa depan.