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
Generate build artifacts	Build the project
Sign in, register, and reach the main feed	Your first day
Understand loading and unavailable states	Loading and unavailable states
Find project and demo references or authentication errors	Getting help

Build artifacts are covered in 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

Enter bun run setup in a terminal.
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

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.