josharsh / josharsh/webmcp-tools

Next.js App Router example (SSR-safe registration)

Open
#7 0 comments 0 reactions 0 assignees View on GitHub
documentation good first issue help wanted
Dominant language
TypeScript
Stars
0
Forks
1
PR merge metrics
No merged PRs in 30d

Description

We have a Vite example (`examples/todo`). Next.js is where most React users will hit the SSR question: `tool()` must only run client-side.

## Task
- `examples/nextjs` with App Router: a 'use client' component using `useWebMCPTool` from `@josharsh/webmcp-react`
- Show the SSR-safe pattern + a short README section on what happens server-side (core already no-ops without `document`; document it)
- Must build in CI (add a step mirroring the todo example)

Contributor guide

Open the contributing guide

Research direction

Start by comparing the existing examples/todo Vite example with the requested examples/nextjs App Router example and its 'use client' component. Document the server-side no-op behavior in the README, then mirror the todo example's CI build step. Done means the example builds in CI and demonstrates useWebMCPTool safely with SSR.

Written by the indexing model from the issue text.

Assessment

Tech stack
next.js, react, typescript
Domain
build-system, ci-cd, documentation, frontend, web-dev
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
62/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.