Skip to content

Quick Start Guide

Get up and running with Rust Terminal Forge in minutes.

Prerequisites

  • Node.js 16+ (recommend using nvm)
  • Rust toolchain (install via rustup)
  • wasm-pack (cargo install wasm-pack)
  • npm or Yarn
  • Git

Local Development

1. Clone the Repository

git clone https://github.com/BA-CalderonMorales/rust-terminal-forge.git
cd rust-terminal-forge

2. Install Dependencies

npm install
wasm-pack build

3. Start the Development Server

npm run dev

Or using Yarn: 

yarn dev

Open http://localhost:8080 in your browser.

4. Build for Production

wasm-pack build --release
npm run build

The production build will be in the dist/ directory.

5. Preview Production Build

npm run preview

Or using Yarn: 

yarn preview

Project Scripts

  • dev: Start development server
  • build: Create production build
  • preview: Preview production build locally
  • test: Run tests
  • lint: Run ESLint
  • format: Format code with Prettier

Deployment

The project is automatically deployed to GitHub Pages on every push to the main branch. Pull requests generate preview deployments for review.

Manual Deployment

  1. Build the project: 

    wasm-pack build --release
npm run build

  2. Deploy to GitHub Pages: 

    git add dist -f
git commit -m "Deploy to GitHub Pages"
git subtree push --prefix dist origin gh-pages

Next Steps