Core

The core library contains reusable code pieces and standards that can be utilized across other libraries and applications within the monorepo. These code pieces are independent of dependencies from other libraries in the monorepo but are essential for certain processes.

Key Principle

The core library must not depend on any other libraries within the monorepo. This RULE must always be maintained to avoid circular dependency issues.

Versioning

Manage library versioning using the @jscutlery/semver tool, which automates semantic versioning based on your git history:

pnpm nx run core:version

For more details, refer to the official SemVer documentation.

Publishing

Publish the library, automatically applying the appropriate tag based on the target environment:

• For feature branches (alpha release):

  pnpm nx run core:publish:feat

• For development (beta release):

  pnpm nx run core:publish:dev

• For production releases (stable release):

  pnpm nx run core:publish:prod

Building

Build the library, specifying the target environment:

• For development environment:

  pnpm nx run core:build:dev

• For production:

  pnpm nx run core:build:prod

Generating GraphQL Types

Generate GraphQL types by connecting to the GraphQL API backend, utilizing GraphQL Code Generator for generating types based on your GraphQL schema:

pnpm nx run core:api-graphql-types

This process ensures that the frontend and backend are in sync by generating types that match the current schema.

Cleaning

Clean up build artifacts to maintain a tidy workspace:

pnpm nx run core:clean

Testing

Run unit tests for the library:

pnpm nx run core:test

Linting

Lint the project to ensure code quality and adherence to standards:

pnpm nx run core:lint