### Install Calligraph

Source: https://github.com/raphaelsalaja/calligraph/blob/main/README.md

Install the Calligraph package using npm.

```bash
npm install calligraph
```

--------------------------------

### Install Dependencies

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Install project dependencies using pnpm.

```sh
pnpm install
```

--------------------------------

### Run Development Server

Source: https://github.com/raphaelsalaja/calligraph/blob/main/apps/web/README.md

Starts the library in watch mode and the Next.js dev server using Turborepo. Use this command from the repository root.

```sh
pnpm dev
```

--------------------------------

### Start Development Server

Source: https://github.com/raphaelsalaja/calligraph/blob/main/WORKFLOW.md

Starts Turborepo in watch mode for development. The library rebuilds on changes and the demo site hot-reloads.

```sh
git checkout -b my-feature
pnpm dev
```

--------------------------------

### Conventional Commits Examples

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Examples of commit messages following the Conventional Commits specification.

```sh
feat: add duration prop
fix: correct LCS alignment for repeated characters
docs: update usage examples
chore: bump motion to v12.1
```

--------------------------------

### Run Web Site Development Server Only

Source: https://github.com/raphaelsalaja/calligraph/blob/main/apps/web/README.md

Starts only the Next.js dev server for the web application. This command filters the execution to the 'web' package.

```sh
pnpm dev --filter=web
```

--------------------------------

### Run Linter

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Run the project's linter and formatter using pnpm lint.

```sh
pnpm lint
```

--------------------------------

### Build Web Application

Source: https://github.com/raphaelsalaja/calligraph/blob/main/apps/web/README.md

Builds the Next.js web application. This command filters the build process to the 'web' package.

```sh
pnpm build --filter=web
```

--------------------------------

### Stage and Commit Changes

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Stage all changes and commit them with a descriptive message.

```sh
git add .
git commit -m "feat: describe your changes"
```

--------------------------------

### Clone the Repository

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Clone the Calligraph repository using the GitHub CLI.

```sh
gh repo clone raphaelsalaja/calligraph
```

--------------------------------

### Create a New Branch

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Create a new Git branch for your development work.

```sh
git checkout -b my-branch
```

--------------------------------

### Create GitHub Release

Source: https://github.com/raphaelsalaja/calligraph/blob/main/WORKFLOW.md

Manually creates a GitHub Release with a specified version and automatically generates release notes based on commits.

```sh
gh release create v1.x.x --title "v1.x.x" --generate-notes
```

--------------------------------

### Add a Changeset

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Add a changeset for versioning and changelog management using pnpm changeset.

```sh
pnpm changeset
```

--------------------------------

### Custom Transitions with Calligraph

Source: https://github.com/raphaelsalaja/calligraph/blob/main/README.md

Configure custom transitions for Calligraph using Motion's animation properties like type, stiffness, and damping.

```tsx
<Calligraph transition={{ type: "spring", stiffness: 200, damping: 20 }}>
  {text}
</Calligraph>
```

--------------------------------

### Create Pull Request

Source: https://github.com/raphaelsalaja/calligraph/blob/main/CONTRIBUTING.md

Create a new pull request using the GitHub CLI.

```sh
gh pr create
```

--------------------------------

### Calligraph Directory Structure

Source: https://github.com/raphaelsalaja/calligraph/blob/main/AGENTS.md

The Calligraph package is structured as a single-file package with all logic residing in `src/index.tsx`.

```bash
src/
  index.tsx   # everything lives here
```

--------------------------------

### Basic Usage of Calligraph

Source: https://github.com/raphaelsalaja/calligraph/blob/main/README.md

Import and use the Calligraph component in a React application. It takes text content as children and animates transitions when the text changes.

```tsx
import { Calligraph } from "calligraph";
import { useState } from "react";

function App() {
  const [text, setText] = useState("Hello");

  return (
    <>
      <Calligraph>{text}</Calligraph>
      <button onClick={() => setText("World")}>Change</button>
    </>
  );
}
```

--------------------------------

### Manual Package Publish

Source: https://github.com/raphaelsalaja/calligraph/blob/main/WORKFLOW.md

Publishes packages manually, bypassing the automated CI release process. Use this if you need to publish without relying on the CI workflow.

```sh
pnpm publish-packages
```

--------------------------------

### Commit and Push Changes

Source: https://github.com/raphaelsalaja/calligraph/blob/main/WORKFLOW.md

Commits staged changes with a descriptive message and pushes them to the remote repository. This is a prerequisite for the CI to detect pending changesets.

```sh
git add .
git commit -m "feat: describe your change"
git push
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.