Skip to content

notifications Novu#361

Open
gianpaj wants to merge 3 commits into
mainfrom
claude/merge-main-update-novu-Ddkxd
Open

notifications Novu#361
gianpaj wants to merge 3 commits into
mainfrom
claude/merge-main-update-novu-Ddkxd

Conversation

@gianpaj

@gianpaj gianpaj commented May 3, 2026

Copy link
Copy Markdown
Owner

Summary

This PR restructures the SexyVoice.ai project into a monorepo architecture using Turborepo, migrates the main app into apps/web, creates a new apps/docs application, and adds comprehensive agent skills for development guidance. The project now includes structured documentation for Turborepo, React best practices, Supabase/Postgres, Motion animations, and other development tools.

Changes

  • Monorepo Setup: Converted to Turborepo-based monorepo with apps/ and packages/ directories
  • Documentation App: Created apps/docs with API reference, feature guides, and searchable documentation
  • Agent Skills: Added 10+ comprehensive skill modules (Turborepo, React best practices, Supabase, Motion, Tiptap, etc.) with detailed references and best practices
  • Project Configuration: Updated AGENTS.md, ARCHITECTURE.md, added Changelog.md, ROADMAP.md, and GitHub PR template
  • Development Tools: Added .ckignore, .biomeignore, .markdownlint.yml, and updated GitHub Actions workflows
  • Cleanup: Removed legacy files (CLAUDE.md, .env.example, auth pages, dashboard components) and updated Node.js version to 24.9.0

How to test

  1. Verify monorepo structure: ls -la apps/ and ls -la packages/ directories exist
  2. Check documentation app builds: cd apps/docs && pnpm install && pnpm build
  3. Verify agent skills are accessible in .agents/skills/ directory
  4. Review AGENTS.md for updated development guidelines
  5. Confirm GitHub Actions workflows in .github/workflows/ are properly configured

Scope

  • Infra / config
  • Docs
  • Breaking change (project structure reorganization)

Checklist

  • I self-reviewed this PR
  • I updated docs/comments where needed
  • I documented project structure changes in AGENTS.md and ARCHITECTURE.md

Notes for reviewers

This is a significant structural change that reorganizes the entire project. Key points:

  1. Monorepo Migration: The project now uses Turborepo for task orchestration. All build/dev scripts should use turbo run from the root.
  2. App Migration: The main application code should be moved to apps/web/ (currently removed, will be re-added in follow-up PR).
  3. Documentation: The new apps/docs provides searchable API documentation and guides.
  4. Agent Skills: These are development aids for Claude and other AI assistants working on the project. They provide best practices and reference documentation.
  5. Breaking Changes: Developers need to update their workflow to use the new monorepo structure and Turborepo commands.

The actual application code has been temporarily removed to allow for proper restructuring. This should be restored in a follow-up PR with proper monorepo organization.

https://claude.ai/code/session_01BCbdM7MDP7GWKUchoNodRh

- Add @novu/react and @novu/js v3.16.0 to apps/web/package.json
- Create NovuNotificationsProvider component in apps/web/components/providers/
- Integrate NovuProvider and Inbox bell into dashboard sidebar (dashboard.ui.tsx)
- Add NEXT_PUBLIC_NOVU_APPLICATION_IDENTIFIER and NOVU_API_KEY to .env.example
- Migrated from old flat repo structure to monorepo (apps/web/) layout

https://claude.ai/code/session_01BCbdM7MDP7GWKUchoNodRh
@bolt-new-by-stackblitz

Copy link
Copy Markdown

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@vercel

vercel Bot commented May 3, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
sexyvoice Ready Ready Preview, Comment May 3, 2026 6:21pm
sexyvoice-docs Ready Ready Preview, Comment May 3, 2026 6:21pm

Request Review

@gemini-code-assist gemini-code-assist Bot 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.

Code Review

This pull request restructures the repository by introducing a comprehensive set of AI agent rules and skills in the .agents directory, alongside significant updates to project documentation and configuration files. Key changes include the addition of AGENTS.md, updates to ARCHITECTURE.md and README.md, and adjustments to environment and tool configurations. Reviewers identified a few stale references in the new documentation that need updating due to file deletions and directory renames.

I am having trouble creating individual review comments. Click here to see my feedback.

AGENTS.md (69)

medium

The path .cursor/rules/ was renamed to .agents/rules/. This reference in AGENTS.md should be updated to reflect the new path.

- `.cursor/rules/` - database function and migration rules.
+ `.agents/rules/` - database function and migration rules.

AGENTS.md (168)

medium

The file apps/web/.env.example was removed in this pull request. This reference in AGENTS.md should be updated or removed accordingly.

- For environment variable changes, update `AGENTS.md`, `README.md`,
- `apps/web/.env.example`, and `docs/devops.md` in the same change.
+ For environment variable changes, update `AGENTS.md`, `README.md`, and `docs/devops.md` in the same change.

@chatgpt-codex-connector

Copy link
Copy Markdown

💡 Codex Review

- name: Checkout repository
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
with:
fetch-depth: 1

P2 Badge Check out PR ref before handling @claude review comments

This new claude-review job can be triggered by issue_comment on pull requests, but actions/checkout is invoked without an explicit PR ref. For issue_comment events, GitHub sets the workflow SHA/ref to the default branch tip, so the review action analyzes default-branch code instead of the commented PR, producing incorrect inline feedback and potentially missing regressions in the actual change set.

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…ckout ref

- Fix stale .cursor/rules/ path → .agents/rules/ in AGENTS.md
- Fix claude-review job to checkout PR head SHA on issue_comment events
  (previously checked out default branch tip, causing review of wrong code)

https://claude.ai/code/session_01BCbdM7MDP7GWKUchoNodRh
@socket-security

socket-security Bot commented May 3, 2026

Copy link
Copy Markdown

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff Package Supply Chain
Security
Vulnerability Quality Maintenance License
Added@​novu/​js@​3.16.09810010098100
Added@​novu/​react@​3.16.010010010098100

View full report

Copilot AI 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.

Pull request overview

This PR introduces Novu in-app notifications wiring in the apps/web dashboard UI (via a new provider + inbox component), updates the web app’s dependency set accordingly, and adjusts the Claude GitHub Action workflow to checkout the correct PR head SHA when triggered from issue comments.

Changes:

  • Add Novu React SDK dependencies and a NovuNotificationsProvider client wrapper.
  • Embed Novu Inbox into the dashboard sidebar UI.
  • Update workflow checkout behavior for issue_comment triggers; minor CSS formatting cleanup; extend .env.example with Novu-related variables.

Reviewed changes

Copilot reviewed 7 out of 8 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
pnpm-lock.yaml Locks newly added Novu-related dependencies and transitive packages.
apps/web/package.json Adds @novu/js and @novu/react dependencies.
apps/web/components/providers/novu-provider.tsx New client provider component to wrap Novu configuration.
apps/web/app/[lang]/(dashboard)/dashboard.ui.tsx Wraps dashboard UI with provider and renders Novu Inbox in the sidebar header.
apps/web/app/globals.css Formatting cleanup of keyframes/utilities and gradients.
apps/web/.env.example Adds Novu env var placeholders.
AGENTS.md Updates referenced rules directory path to .agents/rules/.
.github/workflows/claude.yml Checks out PR head SHA for issue_comment-triggered runs.
Files not reviewed (1)
  • pnpm-lock.yaml: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +163 to +165
<div className="group-data-[collapsible=icon]:hidden">
<Inbox />
</div>
Comment on lines +15 to +20
const applicationIdentifier =
process.env.NEXT_PUBLIC_NOVU_APPLICATION_IDENTIFIER;

if (!applicationIdentifier) {
return <>{children}</>;
}
Comment thread apps/web/.env.example Outdated

# Novu in-app notifications
NEXT_PUBLIC_NOVU_APPLICATION_IDENTIFIER=your_novu_app_identifier
NOVU_API_KEY=novu_api_key_here
- Only render <Inbox /> when NEXT_PUBLIC_NOVU_APPLICATION_IDENTIFIER is
  set, preventing a broken Novu context in unconfigured environments
- Remove NOVU_API_KEY from .env.example — not wired up server-side yet

https://claude.ai/code/session_01BCbdM7MDP7GWKUchoNodRh
@gianpaj gianpaj changed the title Restructure project: migrate to monorepo with docs app and add agent skills notifications Novu May 4, 2026
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.

3 participants