README.md

January 27, 2026 ยท View on GitHub

Daff.io

Getting Started

  1. Create a .env in your working directory with the absolute path to your daffodil project root set to DAFF_ROOT. For example:
echo "DAFF_ROOT=/workspace/daffodil" >> .env
  1. Build the daffio app:
npx nx run @daffodil/daffio:build
  1. Serve app:
npx ng serve daffio

If you're using a dev container, you'll need to run:

npx ng serve daffio --host 0.0.0.0
  1. Navigate to localhost:4200 in your browser of choice

Project Overview

Daff.io is the web application that explains the features of @daffodil and house the documentation of @daffodil.

Contributing to daff.io

Generally speaking, you don't want to depend directly on the source of a dependency when developing, as that can cause unexpected issues at build and deployment time, as well as downstream effects for the developers that depend on your libraries. Yet, there are instances when quick development cycles that don't require a full rebuild can drastically improve development efficiency. E.g. changing styles in a component library.

For this reason, we have opted to create a secondary project daffio-dev which depends directly on the @daffodil libraries source. This can be utilized for rapid feature prototyping, but should be used sparingly.

daffio-dev does not support linting or building, it only serves the purposes of the internal @daffodil development team.

You can run this project via:

ng serve --project=daffio-dev