# System requirements

## What you need to run Conduit

Bun is the tool required to set up and start Conduit.

This page covers two project jobs:

| If you need to… | Go to |
| --- | --- |
| Prepare the project and start the local application | [Set up and start the project](#set-up-and-start-the-project) |
| Generate build artifacts | [Build the project](#build-the-project) |
| Sign in, register, and reach the main feed | [Your first day](doc:your-first-day) |
| Understand loading and unavailable states | [Loading and unavailable states](doc:loading-and-unavailable-states) |
| Find project and demo references or authentication errors | [Getting help](doc:getting-help) |

Build artifacts are covered in [Build the project](#build-the-project).

## Before you start

Have Bun available and work from the project directory before initializing the project.
Work in the project directory named by the setup instructions.

## Set up and start the project

Initialize the project and start the local application with this procedure.

**Prerequisites**

- Bun is available.
- You are in the project directory.

**Steps**

1. Enter `bun run setup` in a terminal.
2. Enter the command for your situation:

   | Situation | Command |
   | --- | --- |
   | After the initial setup | `bun run start` |
   | After a `git pull` updates the `realworld` submodule | `bun run setup` again |

**Result:** The local application is started from the project directory.

While the root page loads, it can show these messages:

| When | Message |
| --- | --- |
| Tags are loading | `Loading tags...` |
| Tags have loaded and the tag list is empty | `No tags are here... yet.` |
| Articles are loading | `Loading articles...` |
| The following feed has no articles | `Your feed is empty. Follow some users to see their articles here, or check out the Global Feed!` |
| The loaded article list has no articles | `No articles are here... yet.` |

## Build the project

Create the project's build artifacts with this procedure.

**Prerequisites**

- Bun is available.
- You are in the project directory.

**Steps**

1. Enter `bun run build` in a terminal.

**Result:** The build artifacts are stored in `dist/`.