Skip to content

npm-ready client + Fumadocs docs site (client + OpenAPI) - #7

Merged
injoon5 merged 3 commits into
mainfrom
cursor/npm-publish-and-docs-47f2
May 26, 2026
Merged

injoon5 merged 3 commits into
mainfrom
cursor/npm-publish-and-docs-47f2

Conversation

@injoon5

@injoon5 injoon5 commented May 26, 2026 •

Copy link
Copy Markdown
Owner

Summary

Prepares @timeforschool/client for npm publishing and adds a Fumadocs + Next.js documentation site covering both the TypeScript client and the generated HTTP API reference.

New in latest commit: Vercel deployment plan, agent instructions, and CI doc sync.

npm (@timeforschool/client)

  • Repository, homepage, bugs, publishConfig.access: public, sideEffects: false
  • MIT LICENSE, prepack build hook
  • GitHub Actions workflow to publish on release (NPM_TOKEN required)

Docs (apps/docs)

  • Fumadocs MDX for client guides (/docs/client/*)
  • fumadocs-openapi pages generated from Elysia spec (/docs/api/*)
  • npm run openapi:sync exports apps/docs/openapi/openapi.json from the running Elysia app and regenerates API MDX

Vercel (two projects)

Project Root Domain (suggested)
API . api.timefor.school
Docs apps/docs timefor.school or docs.timefor.school

See docs/vercel-deploy.md for step-by-step setup.

Agent / CI doc sync

  • AGENTS.md — agents run npm run openapi:sync when changing src/ API code
  • .cursor/rules/sync-openapi-docs.mdc — Cursor rule on src/** edits
  • .github/workflows/sync-docs.yml — PR fails if docs stale; main auto-commits sync when API changes

Commands

npm run dev:docs
npm run build:docs
npm run openapi:sync

Follow-up

  • Create @timeforschool npm org and NPM_TOKEN secret
  • Create both Vercel projects and attach domains per deploy doc
Open in Web Open in Cursor 

- Publish metadata, LICENSE, and CI workflow for @timeforschool/client
- Add apps/docs Next.js + Fumadocs site with client guides and OpenAPI pages
- Export OpenAPI from Elysia via scripts/export-openapi.ts and openapi:sync

Co-authored-by: Injoon Oh <injoon5@icloud.com>
@vercel

vercel Bot commented May 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
school-api Ready Ready Preview, Comment May 26, 2026 3:29pm

- Add docs/vercel-deploy.md (two-project API + docs strategy)
- Add AGENTS.md and .cursor/rules for openapi:sync on API changes
- Add sync-docs workflow: PR check + auto-commit on main

Co-authored-by: Injoon Oh <injoon5@icloud.com>
Co-authored-by: Injoon Oh <injoon5@icloud.com>
@injoon5
injoon5 marked this pull request as ready for review May 26, 2026 15:35
@injoon5
injoon5 merged commit 91cb311 into main May 26, 2026
4 checks passed

This branch was successfully deployed

1 active deployment
Preview — 6f9f2dcc Deployed May 26, 2026 by vercel[bot]
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.

2 participants