Faisal Journals

Mulai dari Sini

Panduan lengkap setup development environment untuk laptop baru. Semua yang dibutuhkan untuk productive dalam hitungan menit.

DevKit

"Mesin yang bisa di-setup ulang dalam 30 menit adalah mesin yang benar-benar kamu kuasai."

Dokumentasi ini dirancang agar setiap kali berganti laptop (yang terjadi setiap bulan), setup bisa dilakukan secara effortless dan reproducible. Pendekatan yang digunakan adalah Executable Documentation — bukan hanya "baca lalu ketik", tapi dokumentasi yang bisa langsung dieksekusi.

⚡ Quick Start

Clone Repository

git clone git@gitlab.com:faisal-affan/demo/news.git news_faisal
cd news_faisal

Jalankan Setup Script

chmod +x scripts/setup.sh && ./scripts/setup.sh

Script ini akan otomatis install: Homebrew, Git, Node.js, pnpm, Bun, VSCode + extensions, dan semua project dependencies.

Setup Environment

cp .env.example .env
# AUTH_SECRET sudah auto-generated oleh setup script

Run Development Server

pnpm dev
# Buka http://localhost:3000

Untuk setup manual atau pemahaman mendalam, baca setiap section di bawah secara berurutan.

🏗️ Arsitektur Setup (4 Phase)

Setup dibagi menjadi 4 fase berurutan, dari level OS hingga level project:

graph LR
    A[Phase 1\nBase System] --> B[Phase 2\nIDE & Editor]
    B --> C[Phase 3\nLanguage & SDKs]
    C --> D[Phase 4\nInfrastructure]
    style A fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    style B fill:#e3f2fd,stroke:#1565c0,stroke-width:2px
    style C fill:#fff3e0,stroke:#e65100,stroke-width:2px
    style D fill:#fce4ec,stroke:#c62828,stroke-width:2px

Phase 1: Base System

macOS preferences, Homebrew, Brewfile, dan core CLI tools. Fondasi utama yang harus diinstall pertama kali.

Phase 2: IDE & Editor

Visual Studio Code, extensions, settings.json, profiles, dan keyboard shortcuts.

Phase 3: Language & SDKs

Node.js, pnpm, Bun, TypeScript, dan version management. Setup runtime untuk development.

Phase 4: Infrastructure

Docker, deployment, CI/CD, dan container management untuk production.

Maintenance & Cleanup

Prosedur uninstall, teardown, dan cleanup. Agar mesin tetap bersih saat software tidak lagi digunakan.

📊 Version Matrix

Tabel kompatibilitas tools yang digunakan di project ini:

ToolMinimumRecommendedCurrent di Project
Node.js18.0.018.x LTS>= 18
pnpm10.28.210.28.210.28.2
Bunlatestlatestlatest
Next.js16.0.016.0.1016.0.10
React19.0.019.2.019.2.0
TypeScript5.0.05.9.35.9.3
Tailwind CSS4.0.04.1.164.1.16
Docker Engine20.0.0latestopsional

✅ Verifikasi Setup

Jalankan command ini untuk memastikan semua tools terinstall:

make check

Output yang diharapkan:

Checking required tools...
  ✓ Node.js v22.x.x
  ✓ pnpm 10.28.2
  ✓ Bun 1.x.x
  ✓ Git 2.x.x
  ✓ Docker 28.x.x (optional)

📦 Project Repository

KeyValue
GitLabgit@gitlab.com:faisal-affan/demo/news.git
Branch Utamadev
Productionhttps://news.faisalaffan.com
Localhosthttp://localhost:3000
Edit on GitHub

Last updated on

macOS & Homebrew

Fondasi sistem operasi macOS, Homebrew package manager, Brewfile, dan core CLI tools yang harus diinstall pertama kali.