From 0fde237e1ade8e27536b776c38eccd309ec6b7fb Mon Sep 17 00:00:00 2001
From: Elia Pari <37016865+ailequal@users.noreply.github.com>
Date: Mon, 30 Sep 2024 13:46:25 +0200
Subject: [PATCH] Add local setup instruction

---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/README.md b/README.md
index 2f0a3be3..c74682bc 100644
--- a/README.md
+++ b/README.md
@@ -11,3 +11,38 @@ This (original) fork is now in a strict maintenance-only mode. Pull requests are
 Please see other active forks for further refinements and developments of the tutorial and the emulator:
 https://github.com/skilldrick/easy6502/network
 
+## Local setup
+
+To run the project locally follow these steps.
+
+Make sure that the latest version of Ruby is correctly installed on your system, you can use [rbenv](https://github.com/rbenv/rbenv).
+
+Clone the repository:
+
+```bash
+git clone https://github.com/skilldrick/easy6502.git
+cd easy6502
+```
+
+Create a new `Gemfile` in the root of the project with the following content:
+
+```ruby
+source 'https://rubygems.org'
+
+gem 'jekyll'
+gem 'github-pages', group: :jekyll_plugins
+```
+
+Then execute these commands:
+
+```bash
+# install the dependencies
+gem install bundler
+bundle install
+
+# build the project (inside "_site" directory)
+bundle exec jekyll build
+
+# serve the project locally and watch for changes (from "_site" directory)
+bundle exec jekyll serve
+```