> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wrixton.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Clone and Run the War.re Apps on Your Local Machine

> Set up a local development environment for the war.re monorepo and get a Next.js app running on localhost:3000 in just a few steps.

The war.re monorepo contains two independent Next.js apps: `main/` (served at war.re) and `subdomains/ryan/` (served at ryan.war.re). You work on each app in isolation — there is no shared build or root-level `yarn install`. This guide walks you through cloning the repo, picking the app you want, and starting a development server.

## Prerequisites

Before you begin, make sure you have the following tools installed:

* **Node.js** — check with `node --version`
* **yarn** — the package manager used by both apps; check with `yarn --version`
* **git** — to clone the repository

## Setup

<Steps>
  <Step title="Clone the repository">
    Clone the war.re monorepo from GitHub:

    ```bash theme={null}
    git clone https://github.com/rwwarren/war.re.git
    cd war.re
    ```
  </Step>

  <Step title="Pick an app to work on">
    The monorepo contains two completely separate Next.js apps. Navigate into whichever one you want to work on:

    ```bash theme={null}
    # For the main war.re site
    cd main

    # — or —

    # For the ryan.war.re resume
    cd subdomains/ryan
    ```

    Every command you run — `yarn install`, `yarn dev`, `yarn build` — must be executed from inside one of these app directories. There is no root-level install step.
  </Step>

  <Step title="Install dependencies">
    Install the app's dependencies with yarn:

    ```bash theme={null}
    yarn install
    ```

    Each app has its own `package.json` and `yarn.lock`, so dependencies are fully isolated between `main/` and `subdomains/ryan/`.
  </Step>

  <Step title="Start the development server">
    Start the Next.js development server:

    ```bash theme={null}
    yarn dev
    ```

    When the server is ready, you'll see output similar to this:

    ```
    ▲ Next.js
      - Local:        http://localhost:3000
      - Environments: .env.local

     ✓ Starting...
     ✓ Ready in 1234ms
    ```

    Open [http://localhost:3000](http://localhost:3000) in your browser to see the app. Both apps boot on port 3000 by default, so only run one dev server at a time unless you override the port with `yarn dev -p 3001`.
  </Step>
</Steps>

<Info>
  Both `main/` and `subdomains/ryan/` use the same set of yarn commands (`yarn dev`, `yarn build`, `yarn lint`, and so on), but they are completely independent projects. Changes in one app have no effect on the other, and each app maintains its own lock file.
</Info>