Skip to content

add page for monorepo support in LGP#268

Merged
Isaac Francisco (isahers1) merged 13 commits into
mainfrom
isaac/monorepo_stuff
Sep 4, 2025
Merged

add page for monorepo support in LGP#268
Isaac Francisco (isahers1) merged 13 commits into
mainfrom
isaac/monorepo_stuff

Conversation

@isahers1

Copy link
Copy Markdown
Contributor

No description provided.

@github-actions

Copy link
Copy Markdown
Contributor

Preview ID generated: preview-isaacm-1756422678-de05a32


## LangGraph.json Configuration

Place your `langgraph.json` file in your agent directory (not the monorepo root) and structure it properly:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

prefer something like "and structure it in the following way:"

will also let the docs folks do all the wordsmithing

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are we removing support for putting it in the root of your directory?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, you can still do that this just makes the devex better for JS people to not have to use postinstall scripts and whatnot

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe something like

"Place the langgraph.json file in your agent’s directory (not in the monorepo root). Ensure the file follows the required structure:"

Comment thread src/langgraph-platform/monorepo-support.mdx

2. **Use relative paths for Python**: For Python monorepos, use relative paths like `"../../shared-package"` in the `dependencies` array.

3. **Leverage workspace features for JS**: For JavaScript/TypeScript, use your package manager's workspace features to manage dependencies between packages.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

uv also supports this fyi

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yeah, you have to call uv sync though right? like we call uv pip install, which I don't think does this?

Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx Outdated

@hinthornw William FH (hinthornw) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The language here means this: https://github.com/langchain-ai/langgraph-example-monorepo would no longer be considered a good practice right?

@github-actions

Copy link
Copy Markdown
Contributor

Preview ID generated: preview-isaacm-1756500520-81a76bb

@katmayb Kathryn May (katmayb) left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just added some suggestions from a docs perspective, otherwise feel free to merge when this is ready.

Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx

## LangGraph.json Configuration

Place your `langgraph.json` file in your agent directory (not the monorepo root) and structure it properly:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe something like

"Place the langgraph.json file in your agent’s directory (not in the monorepo root). Ensure the file follows the required structure:"


## Repository Structure

<Tabs>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey Isaac Francisco (@isahers1), I'm going to swap out the <Tabs> structure for <CodeGroup> in the LGP docs gradually, which means that when a user selects JS all the code blocks on the page will sync to that. If you have time, can you switch these out for the code group structure? Here's an example:

If not, I can update later 👍

Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx Outdated
Comment thread src/langgraph-platform/monorepo-support.mdx
@github-actions

github-actions Bot commented Sep 3, 2025

Copy link
Copy Markdown
Contributor

Preview ID generated: preview-isaacm-1756924815-f8eb81a

Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com>
@github-actions

github-actions Bot commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Preview ID generated: preview-isaacm-1757013395-4a89916

@github-actions

github-actions Bot commented Sep 4, 2025

Copy link
Copy Markdown
Contributor

Preview ID generated: preview-isaacm-1757014115-7597851

@isahers1
Isaac Francisco (isahers1) marked this pull request as ready for review September 4, 2025 19:30
@isahers1
Isaac Francisco (isahers1) merged commit 58c9b37 into main Sep 4, 2025
10 of 11 checks passed
@isahers1
Isaac Francisco (isahers1) deleted the isaac/monorepo_stuff branch September 4, 2025 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants