Skip to main content

Installation & Setup

This guide covers how to install the Farm Data Model (FDM) packages for use in your own projects, and how to set up the monorepo for contributing to FDM development.

[!WARNING] FDM is currently in an alpha stage of development.FDM is currently in an alpha stage of development. This means the software is under active development, and while core functionalities are stable, there may still be significant changes to its API and schema before the 1.0.0 release. Until version 1.0.0, database schema migrations are not automatically handled for all breaking changes, and manual intervention might be required for schema updates between versions. Please use caution and be prepared for potential breaking changes. We encourage you to experiment and provide feedback.

Using FDM Packages​

To use the FDM libraries (like @svenvw/fdm-core, @svenvw/fdm-data, etc.) in your project:

Prerequisites​

  • Node.js (Check package.json engines field in the specific package for recommended version)
  • A package manager like pnpm, npm, or yarn.
  • For @svenvw/fdm-core: A running PostgreSQL-compatible database.

Installation​

Install the desired packages using your package manager. For example, using pnpm:

# Install the core library
pnpm add @svenvw/fdm-core

# Install the data catalogues library
pnpm add @svenvw/fdm-data

# Install the calculator library
pnpm add @svenvw/fdm-calculator

(Note: Replace @svenvw/... with the actual published package names if they differ).

Setup​

  • Database: Ensure your PostgreSQL database is running.
  • Environment Variables: Configure the necessary environment variables, especially the database connection string for @svenvw/fdm-core. Refer to the "Setup Connection" guide in the "Getting Started" section for details.

Contributing to FDM​

If you want to contribute to the development of FDM itself:

Prerequisites​

  • Git
  • Node.js (Check .node-version or root package.json engines field)
  • pnpm (Corepack recommended: corepack enable)
  • Docker & Docker Compose (Optional, for easy local database setup)

Setup​

  1. Fork & Clone: Fork the main SvenVw/fdm repository and clone your fork. 
    git clone https://github.com/SvenVw/fdm.git
    cd fdm
  2. Install Dependencies: Use pnpm from the monorepo root. 
    pnpm install
  3. Environment & Database: Set up required .env files (copy from .env.example in package directories) and ensure a PostgreSQL database is running and configured (e.g., using docker compose up -d from the root).

For detailed development workflows (building, testing, linting, changesets), please refer to the Contributing guide.