# Tech Stack — Gravity Web

> AI 에이전트는 구현 전 이 문서를 확인하여 올바른 기술/버전을 사용합니다.

## 언어 & 런타임

| 항목 | 버전 | 비고 |
|------|------|------|
| Node.js | 시스템 설치 (`node`, `npm`) | 서버 + 빌드 |
| Python | `C:\ProgramData\miniforge3\envs\gravity_web\python.exe` | 헬퍼 스크립트 전용 |

## 프레임워크 & 라이브러리

| 항목 | 용도 |
|------|------|
| Express | HTTP 서버 |
| ws | WebSocket 서버 |
| chrome-remote-interface | CDP 클라이언트 |

## 프론트엔드

| 항목 | 설명 |
|------|------|
| 방식 | Vanilla HTML/CSS/JS (SPA) — 프레임워크 없음 |
| 테마 | 다크 테마 |
| 통신 | REST API + WebSocket (실시간) |

## 개발 도구

| 도구 | 명령어 |
|------|--------|
| 의존성 설치 | `cmd /c npm install` (server 디렉토리에서) |
| 서버 실행 | `cmd /c node index.js` (server 디렉토리에서, port 3300) |
| Antigravity 실행 | `"%LOCALAPPDATA%\Programs\Antigravity\Antigravity.exe" --remote-debugging-port=9000` |

## Shell 주의사항

| 항목 | 규칙 |
|------|------|
| `curl` | PowerShell에서 `Invoke-WebRequest` 별칭 → **반드시 `curl.exe`** |
| `npm` | 실행 정책 문제 시 **`cmd /c npm`** 사용 |
| JSON 처리 | `.py` 스크립트로 만들어 실행 (PowerShell 이스케이핑 문제 방지) |
