Skip to content

input-output-hk/lace

Folders and files

NameName
Last commit message
Last commit date
Dec 20, 2024
May 31, 2023
Aug 17, 2023
Jan 10, 2025
Jan 8, 2025
Jan 10, 2025
Oct 2, 2024
May 31, 2023
May 31, 2023
Jan 8, 2025
Oct 2, 2024
Jun 1, 2023
Apr 30, 2024
May 31, 2023
Jun 28, 2024
Jun 1, 2023
May 31, 2023
Sep 11, 2024
Sep 10, 2024
Oct 2, 2024
Sep 5, 2024
Sep 5, 2024
Jan 8, 2025
Nov 8, 2024
Aug 14, 2024
Dec 9, 2024
Jan 10, 2025

Repository files navigation

Lace

Quality Gate Status Security Rating Vulnerabilities

Project structure

Apps

Packages

Getting started

Authorize to GitHub Package Registry

Lace depends on @input-output-hk/lace-ui-toolkit package, which is published from lace-ui-toolkit repository to Github Package Registry. In order to install dependencies from GitHub Package Registry, Personal Access Token needs to be provided.

Important

It is required to generate Personal Access Token (PAT) to be able to authorize to Github Package Registry prior to installing projects dependencies. For more details follow this link: Working with the npm registry.

How to authorize to GitHub Package Registry

  1. Go to Profile/Settings/Developer Settings/Personal access tokens/Tokens (classic) to generate a new PAT
  2. Select at least read:packages permissions to be able to download packages from GitHub Package Registry
  3. Create ~/.yarnrc.yml file in your home directory and insert:
npmScopes:
  input-output-hk:
    npmAlwaysAuth: true
    npmAuthToken: YOUR_GITHUB_PAT
    npmRegistryServer: 'https://npm.pkg.github.com'

For more details check GitHub's guide: Authenticating with personal access token

Install dependencies

yarn install

Setup environment variables

cp ./apps/.env.defaults ./apps/.env

Once .env files is created adjust it to your needs, and update LACE_EXTENSION_KEY

Build packages and extension

yarn build

Install Lace extension in Chrome / MS Edge browser

  1. Go to chrome://extensions/ or edge://extensions/ in selected web browser
  2. Enable Developer mode
  3. Click Load unpacked and point out dist folder from apps/browser-extension-wallet which is built in previous step
  4. Extension should be visible in Extensions and ready to use.

Dev commands

yarn [app] [command]

Available [app] options:

Available [command] options:

  • build
  • build-deps - build only dependencies of a given app
  • watch - build and watch
  • watch-deps - build and watch only dependencies of a given app

You can mix them together.

Examples:

Working with UI Toolkit

In this workspace UI Toolkit is used in 4 places:

  • apps/browser-extension-wallet
  • packages/core
  • packages/shared-wallets
  • packages/staking

Based on the specific use case we can link it on:

Linking UI Toolkit on app level, allows you to see all changes in app and packages using it.

Linking UI Toolkit on package level, allows you to develop components in isolation using for example Storybook.

Audit

Lace has been independently audited and manually verified by external auditor, FYEO, so the Lace team can improve code quality and security – giving you greater peace of mind. You can view the full report at lace.io/lace-audit-report