# Vance Terminal

Vance Terminal is an interactive narrative game that simulates a retro terminal interface. Explore a mysterious file system, uncover secrets, and piece together the story of the enigmatic VANCE CORP.

## Features

- **Interactive Terminal:** A classic command-line interface where you can execute commands.

- **Narrative Exploration:** Uncover the story by navigating the file system, reading emails, and decrypting secret files.

- **Retro Aesthetic:** A fully immersive "Old TV" experience with amber phosphor glow, scanlines, screen curvature, and a realistic bezel.

- **Command-Line Simulation:** Use familiar commands like `ls`, `cd`, and `cat`, plus game-specific commands like `login` and `decrypt`.

## Available Commands

- `help`: Show available commands.

- `ls` / `dir`: List directory contents.

- `cd [dir]`: Change directory.

- `cat [file]`: Read file content.

- `login [user]`: Log in to a user account.

- `decrypt [file] [key]`: Decrypt an encrypted file using a key.

- `whoami`: Show current user.

- `clear` / `cls`: Clear the screen.

## Walkthrough / Guide

**Objective:** Explore the file system, uncover the mystery of the "Static", and decide the fate of the system.

### Step 1: The Basics

*   **Start**: Type `tutorial` to learn the controls.

*   **Explore**: Use `ls` to see files and `cd [folder]` to move around.

*   **Read**: Use `cat [filename]` to read text files. Start with `cat notes.txt`.

### Step 2: Finding Clues

*   **Hint**: The notes mention a "resignation draft" in the `/trash` folder.

*   **Action**: Go to `/trash` and read the draft. Look for a keyword that might be a password.

### Step 3: Accessing Vance's Account

*   **Login**: Use `login vance` and enter the password you found (Hint: it's related to "noise").

*   **Explore**: Once logged in, check the `mail` and `research` folders.

### Step 4: The Truth

*   **Decrypt**: Find the encrypted file in `research`. You'll need a key, which is hidden in an email in the `mail` folder.

*   **Command**: Use `decrypt signal_analysis.enc [KEY]`.

### Step 5: The Choice

*   **Endings**: Once the entity is released, you have two choices:

    1.  **Upload**: Spread the entity to the world (`upload world`).

    2.  **Destroy**: Purge the system to stop it (`delete system_core`).

## Getting Started

To get a local copy up and running, follow these simple steps.

### Prerequisites

- Node.js installed on your machine. You can download it [here](https://nodejs.org/).

### Installation & Running

1.  Clone the repo

    ```sh

    git clone https://github.com/BaoNguyen3oro/vance-terminal.git

    ```

2.  Navigate to the project directory

    ```sh

    cd vance-terminal

    ```

3.  Install NPM packages

    ```sh

    npm install

    ```

4.  Run the development server

    ```sh

    npm run dev

    ```

    The application will be available at `http://localhost:5173/` (or the next available port).

## Technologies Used

- [React](https://reactjs.org/)

- [Vite](https://vitejs.dev/)

- [Tailwind CSS](https://tailwindcss.com/) (v4)