halvor.
Learn Lore / Your first Lore project
FIELD GUIDE 02 / HANDS ON

Your first Lore project

Create a disposable local project, then stage, commit and push your first file.

10 min practice · Beginner friendly · Reviewed 16 October 2026

Start with a practice environment

Use an empty folder and files you can discard. Install the CLI and start the local demo server using the official quickstart, step 1. Keep its terminal open, then use a second terminal below.

Practice only

The official demo uses a temporary store and a generated certificate. It is not durable project hosting. Keep real projects on a configured, backed-up server; do not replace an existing project or server for this exercise.

TERMINAL
lore --version

If the command is not found, reopen your terminal after installation and check the official installation guide.

Create a small repository

From a directory where you keep practice projects, make a new folder. The example below connects only to the local demo you started.

TERMINAL
mkdir lore-practice
cd lore-practice
lore repository create lore://127.0.0.1:41337/lore-practice

You should now have a working tree with a .lore directory. Keep that directory: it holds local repository state.

Write a file, then save a revision

Create README.md in your editor, add a short project description, and save it as UTF-8. Then run:

TERMINAL
lore stage README.md
lore status --scan
lore commit "Add a project introduction"

Look for README.md in the staged changes before committing. A successful commit reports a new revision.

Push your first change

TERMINAL
lore push
lore status --scan

The push sends the revision to your local demo server. Keep the server running if you want to continue practising. When Halvor preview access opens, use the clone URL provided by your project instead of this local address.

You have practised: creating a repository, staging a file, recording a revision and pushing it.

Go to the source

Written for Halvor learners, with references to Epic Games’ official Lore documentation. Lore is evolving; check your installed version and its help when commands differ.

Official quickstart ↗Install the CLI ↗