Getting Started

This guide will help you set up and run the EF Blockchain Web3 project locally.

Prerequisites

Before you begin, ensure you have the following tools installed:

Git: Download Git
Node.js: Download Node.js (v16 or later)
.NET SDK: Download .NET (version 8.0)
Visual Studio Code: Download VS Code (recommended)

Optional Tools

Yarn: For package management
Postman: For API testing
NVM: For Node.js version management

Installation

1. Clone the Repository

git clone https://github.com/efernandes-tech/web3-001-ef-blockchain.git
cd web3-001-ef-blockchain

2. Backend Setup

# Navigate to backend API folder
cd backend/src/EF.Blockchain.Server

# Restore dependencies
dotnet restore

# Build the project
dotnet build

# Run the application
dotnet run

The backend API will start at: http://localhost:5000

3. Frontend Setup

# Navigate to frontend folder (from project root)
cd frontend/site

# Install dependencies
yarn install
# or
npm install

# Start the development server
yarn start
# or
npm start

The frontend application will open at: http://localhost:3000

Next Steps

Project Structure - Understand the codebase organization

Table of Contents