Skip to content

390-feat: Add open graph previews #894

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 50 commits into
base: main
Choose a base branch
from

Conversation

LaraNU
Copy link
Collaborator

@LaraNU LaraNU commented May 14, 2025

What type of PR is this? (select all that apply)

  • πŸ• Feature
  • πŸ› Bug Fix
  • 🚧 Breaking Change
  • πŸ§‘β€πŸ’» Code Refactor
  • πŸ“ Documentation Update

Description

  • Created reusable generatePageMetadata utility function for consistent metadata generation
  • Added metadataBase to root layout for proper absolute URL resolution
  • Implemented complete metadata (title + description + OG image) on all pages using the new utility

Problem
Project uses output: 'export' which limits dynamic image generation capabilities https://github.com/vercel/next.js/issues/51147

  • Implemented standalone pre-build OG image generation script that:
  1. Runs before dev and build commands (added to package.json scripts)
  2. Generates all required OG images during development/build time
  3. Uses React-like JSX syntax (createElement) for flexible template creation
  4. Supports:
  • Custom fonts loading
  • Dynamic data injection (course dates, titles)
  • SVG/PNG assets integration
  • Parallel image generation

When running the project in development mode (npm run dev), developers need to:

Modify metadataBase in the root layout:

- metadataBase: new URL('https://rs.school'),
+ metadataBase: new URL('http://localhost:3000'),
  1. OG images require absolute URLs for proper display in social previews
  2. The current implementation links images to their deployment environment
  3. This ensures local development matches the production behavior while using correct local URLs

Related Tickets & Documents

Screenshots, Recordings

I've deployed a test version with the new metadata system: Preview Deployment

For courses
image

For pages
image

Added/updated tests?

  • πŸ‘Œ Yes
  • πŸ™…β€β™‚οΈ No, because they aren't needed
  • πŸ™‹β€β™‚οΈ No, because I need help

[optional] Are there any post deployment tasks we need to perform?

[optional] What gif best describes this PR or how it makes you feel?

Summary by CodeRabbit

  • New Features

    • Automated generation of Open Graph images for courses and key pages, improving social sharing visuals.
    • Centralized and enriched metadata for all main pages and courses, including descriptions, keywords, canonical URLs, robots directives, and Open Graph images for better SEO and sharing.
    • Added new scripts to automate OG image generation during development and build processes.
  • Bug Fixes

    • None.
  • Chores

    • Updated dependencies and configuration files to support new scripts and features.
    • Added new utility functions and constants to streamline data handling and image generation.

Copy link
Contributor

coderabbitai bot commented May 14, 2025

πŸ“ Walkthrough

Walkthrough

This update introduces automated Open Graph (OG) image generation for courses and key pages, adds scripts and utilities for this purpose, and centralizes metadata generation. Metadata across many pages is enhanced to include comprehensive descriptions, keywords, canonical URLs, robots directives, and OG image references. Supporting types, constants, and helper functions are added.

Changes

File(s) / Group Change Summary
.gitignore Added /public/og to ignored paths.
package.json, tsconfig.json Added OG generation script, dependency (tsx), and included script in build/dev; updated formatting and includes.
src/shared/helpers/generate-page-metadata.ts New helper for standardized metadata object creation.
src/shared/constants.ts Added OG folder constants.
src/app/layout.tsx Set metadataBase property.
src/app/page.tsx, src/app/courses/page.tsx, src/app/mentorship/page.tsx, src/app/community/page.tsx, src/app/docs/[lang]/page.tsx, src/app/docs/[lang]/[...slug]/page.tsx Enhanced generateMetadata to use new helper and include richer metadata fields.
src/app/courses/*.tsx (all course pages) Updated generateMetadata functions to provide detailed metadata via helper.
src/app/mentorship/[course]/page.tsx Enhanced metadata with new helper and OG image.
scripts/generate-og-script.ts New script to generate OG images for courses and pages.
scripts/utils/ensure-dir-exists.ts, scripts/utils/generate-image.ts, scripts/utils/load-fonts.ts, scripts/utils/load-image-as-data-uri.ts New utility functions for directory creation, image rendering, font loading, and image data URI conversion.
scripts/api/get-courses-logo.ts, scripts/api/get-courses-schedule.ts, scripts/api/get-combain-data-courses.ts New API helpers to fetch and combine course data for OG image generation.
scripts/shared/constants.ts Centralized page titles and descriptions for OG images.
scripts/types/types.ts Added types for course, page, and font data.
scripts/view/courses-tree/generate-courses-tree.tsx, scripts/view/courses-tree/generate-courses-tree.styles.ts OG image React component and styles for courses.
scripts/view/pages-tree/generate-pages-tree.tsx, scripts/view/pages-tree/generate-pages-tree.styles.ts OG image React component and styles for pages.

Sequence Diagram(s)

sequenceDiagram
    participant Script as generate-og-script.ts
    participant API as API Helpers
    participant Utils as Utilities
    participant View as React OG Components
    participant FS as File System

    Script->>API: getCombinedDataCourses()
    API-->>Script: Course data with logos and schedules

    Script->>Utils: load fonts
    Script->>View: createCourseTree(course)
    View-->>Script: JSX tree

    Script->>Utils: generateImage(tree, fonts)
    Utils-->>Script: PNG buffer

    Script->>FS: Write OG image file

    Script->>View: createPageTree(page)
    View-->>Script: JSX tree

    Script->>Utils: generateImage(tree, fonts)
    Utils-->>Script: PNG buffer

    Script->>FS: Write OG image file
Loading

Assessment against linked issues

Objective Addressed Explanation
Implement Open Graph Previews for site and courses (#390) βœ…
Add proper meta descriptions and enrich metadata for SEO and sharing (#390) βœ…

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

πŸ”§ ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

npm warn config production Use --omit=dev instead.
npm error Exit handler never called!
npm error This is an error with npm itself. Please report this error at:
npm error https://github.com/npm/cli/issues
npm error A complete log of this run can be found in: /.npm/_logs/2025-05-18T16_54_27_352Z-debug-0.log

✨ Finishing Touches
  • πŸ“ Generate Docstrings

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❀️ Share
πŸͺ§ Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 5

🧹 Nitpick comments (11)
scripts/utils/fetch-courses-list.ts (1)

3-10: Good implementation with proper error handling

The function correctly handles API errors and type casting. Consider adding a timeout to the fetch request for better error handling in case of slow network conditions.

 export async function fetchCoursesList(url: string): Promise<ApiCourse[]> {
-  const res = await fetch(url);
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), 10000);
+  
+  try {
+    const res = await fetch(url, { 
+      signal: controller.signal 
+    });
+    
+    if (!res.ok) {
+      throw new Error(`API error ${res.status}`);
+    }
+    return (await res.json()) as ApiCourse[];
+  } finally {
+    clearTimeout(timeoutId);
+  }

-  if (!res.ok) {
-    throw new Error(`API error ${res.status}`);
-  }
-  return (await res.json()) as ApiCourse[];
 }
src/app/mentorship/[course]/page.tsx (1)

9-9: Consider course-specific metadata for each course page

Currently, this course-specific page uses the same generic mentorship description and image as the main mentorship page. For better SEO and social media sharing, consider generating unique descriptions and OG images for each course.

Also applies to: 11-16

src/app/courses/reactjs/page.tsx (1)

11-12: Consider updating the React course description.

While the title is correctly fetched, the description doesn't seem specific to the React course - it appears to be a generic RS School description rather than React-specific content.

  const title = await getCourseTitle(courseName);
- const description = 'Everyone can study at RS School, regardless of age, professional employment, or place of residence';
+ const description = 'Learn modern React, hooks, state management, and build production-ready applications with our comprehensive React course';
src/app/courses/javascript/page.tsx (1)

3-3: Fix extra quotation mark in description

The description contains an erroneous closing quotation mark at the end of the string.

- const description = 'Everyone can study at RS School, regardless of age, professional employment, or place of residence".';
+ const description = 'Everyone can study at RS School, regardless of age, professional employment, or place of residence.';

Also applies to: 11-20

scripts/utils/course-info.ts (2)

5-19: The getCourseInfo function looks good but could be simplified

The function correctly extracts and formats course dates from course information, but the conditional logic in lines 8-14 could be simplified.

export const getCourseInfo = (coursesList: ApiCourse[], slug: string): string => {
  const courseInfo: ApiCourse | undefined = coursesList.find((c) => c.descriptionUrl.toLowerCase().endsWith(slug));

-  let rawDate: string;
-
-  if (!courseInfo) {
-    rawDate = '';
-  } else {
-    rawDate = courseInfo.startDate;
-  }
-
-  const formattedDate: string = rawDate ? dayjs(rawDate).format('MMM DD, YYYY') : 'TBD';
+  const rawDate = courseInfo?.startDate || '';
+  const formattedDate: string = rawDate ? dayjs(rawDate).format('MMM DD, YYYY') : 'TBD';

  return formattedDate;
};

5-6: Consider adding null check for coursesList parameter

The function assumes coursesList is always a valid array, but doesn't validate this input.

-export const getCourseInfo = (coursesList: ApiCourse[], slug: string): string => {
+export const getCourseInfo = (coursesList: ApiCourse[] | null | undefined, slug: string): string => {
+  if (!coursesList || !Array.isArray(coursesList)) {
+    return 'TBD';
+  }
  const courseInfo: ApiCourse | undefined = coursesList.find((c) => c.descriptionUrl.toLowerCase().endsWith(slug));
src/app/courses/javascript-ru/page.tsx (1)

12-12: Consider moving description to constants

The description is hardcoded in this file but may be reused across course pages.

If this description is common across courses, consider moving it to a constants file.

src/app/docs/[lang]/[...slug]/page.tsx (1)

48-48: Consider moving description to constants

Similar to course pages, this hardcoded description could be moved to a constants file.

If this description appears in multiple docs-related pages, consider extracting it to a constants file.

dev-data/open-graph.data.ts (1)

21-27: Naming convention inconsistency.

Consider using consistent naming conventions across the constants.

-export const Descriptions = {
+export const DESCRIPTIONS = {

This would match the uppercase naming pattern used for COURSE_SLUGS and RS_PAGES.

scripts/utils/generate-courses-tree.ts (1)

1-122: Extract common style values as constants

The component has multiple hardcoded style values (colors, sizes, fonts) that are repeated throughout. Consider extracting these as constants for better maintainability.

import { JSX, createElement } from 'react';

+// Design constants
+const COLORS = {
+  dark: '#000',
+  light: '#f0f2f5',
+  accent: '#ffda1f'
+};
+
+const FONTS = {
+  family: 'Inter',
+  sizes: {
+    large: 72,
+    medium: 50,
+    small: 38,
+    body: 36
+  }
+};
+
+const IMAGE_DIMENSIONS = {
+  width: 1200,
+  height: 630,
+  logo: 250
+};

export function createCourseTree(
  /* ... parameters remain the same ... */
) {
  return createElement(
    'div',
    {
      style: {
        display: 'flex',
        width: IMAGE_DIMENSIONS.width,
        height: IMAGE_DIMENSIONS.height,
        fontFamily: FONTS.family,
        fontWeight: 400,
      },
    },
    /* ... remainder of the function using these constants ... */
  );
}
scripts/utils/generate-page-tree.ts (1)

30-40: Alt text doesn’t match the image content.

The map background is declared with alt: 'RS Logo', which is misleading and hurts accessibility. Use a description that actually represents the image purpose (e.g. "World map background" or empty alt if it’s purely decorative).

-  alt: 'RS Logo',
+  alt: 'World map background',
πŸ“œ Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between e3a4b26 and b8fa55d.

β›” Files ignored due to path filters (18)
  • package-lock.json is excluded by !**/package-lock.json
  • public/fonts/Inter_28pt-Bold.ttf is excluded by !**/*.ttf
  • public/fonts/Inter_28pt-Regular.ttf is excluded by !**/*.ttf
  • src/shared/assets/og-logos/angular.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/aws-cloud-developer.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/aws-devops.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/aws-fundamentals.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/javascript-preschool-ru.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/javascript-ru.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/javascript.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/map.png is excluded by !**/*.png
  • src/shared/assets/og-logos/mentor-with-his-students.png is excluded by !**/*.png
  • src/shared/assets/og-logos/nodejs.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/reactjs.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/rs-banner.png is excluded by !**/*.png
  • src/shared/assets/og-logos/rs-banner.svg is excluded by !**/*.svg
  • src/shared/assets/og-logos/rs-school.png is excluded by !**/*.png
  • src/shared/assets/og-logos/rss-logo.svg is excluded by !**/*.svg
πŸ“’ Files selected for processing (32)
  • .gitignore (1 hunks)
  • dev-data/open-graph.data.ts (1 hunks)
  • package.json (2 hunks)
  • scripts/generate-og-script.ts (1 hunks)
  • scripts/types.ts (1 hunks)
  • scripts/utils/course-info.ts (1 hunks)
  • scripts/utils/ensure-dir-exists.ts (1 hunks)
  • scripts/utils/fetch-courses-list.ts (1 hunks)
  • scripts/utils/generate-courses-tree.ts (1 hunks)
  • scripts/utils/generate-image.tsx (1 hunks)
  • scripts/utils/generate-page-tree.ts (1 hunks)
  • scripts/utils/load-fonts.ts (1 hunks)
  • scripts/utils/load-image-as-data-uri.ts (1 hunks)
  • src/app/community/page.tsx (1 hunks)
  • src/app/courses/angular/page.tsx (1 hunks)
  • src/app/courses/aws-cloud-developer/page.tsx (1 hunks)
  • src/app/courses/aws-devops/page.tsx (1 hunks)
  • src/app/courses/aws-fundamentals/page.tsx (1 hunks)
  • src/app/courses/javascript-preschool-ru/page.tsx (1 hunks)
  • src/app/courses/javascript-ru/page.tsx (1 hunks)
  • src/app/courses/javascript/page.tsx (1 hunks)
  • src/app/courses/nodejs/page.tsx (1 hunks)
  • src/app/courses/page.tsx (1 hunks)
  • src/app/courses/reactjs/page.tsx (1 hunks)
  • src/app/docs/[lang]/[...slug]/page.tsx (2 hunks)
  • src/app/docs/[lang]/page.tsx (1 hunks)
  • src/app/layout.tsx (1 hunks)
  • src/app/mentorship/[course]/page.tsx (1 hunks)
  • src/app/mentorship/page.tsx (1 hunks)
  • src/app/page.tsx (1 hunks)
  • src/shared/helpers/generate-page-metadata.ts (1 hunks)
  • tsconfig.json (1 hunks)
🧰 Additional context used
🧬 Code Graph Analysis (7)
src/app/courses/aws-cloud-developer/page.tsx (4)
dev-data/index.ts (1)
  • COURSE_TITLES (36-36)
src/app/courses/reactjs/page.tsx (1)
  • generateMetadata (10-21)
src/shared/helpers/get-course-title.ts (1)
  • getCourseTitle (4-10)
src/shared/helpers/generate-page-metadata.ts (1)
  • generatePageMetadata (1-26)
scripts/utils/fetch-courses-list.ts (1)
scripts/types.ts (1)
  • ApiCourse (1-4)
scripts/utils/course-info.ts (1)
scripts/types.ts (1)
  • ApiCourse (1-4)
src/app/courses/page.tsx (7)
src/app/community/page.tsx (1)
  • generateMetadata (6-17)
src/app/courses/reactjs/page.tsx (1)
  • generateMetadata (10-21)
src/app/page.tsx (1)
  • generateMetadata (6-17)
src/app/mentorship/page.tsx (1)
  • generateMetadata (7-18)
src/app/docs/[lang]/page.tsx (1)
  • generateMetadata (9-20)
src/app/layout.tsx (1)
  • metadata (11-36)
src/shared/helpers/generate-page-metadata.ts (1)
  • generatePageMetadata (1-26)
scripts/generate-og-script.ts (10)
scripts/utils/load-fonts.ts (2)
  • Font (4-9)
  • loadFont (11-23)
dev-data/open-graph.data.ts (3)
  • COURSE_SLUGS (1-11)
  • RS_PAGES (13-19)
  • Descriptions (21-27)
scripts/types.ts (1)
  • ApiCourse (1-4)
scripts/utils/fetch-courses-list.ts (1)
  • fetchCoursesList (3-10)
scripts/utils/ensure-dir-exists.ts (1)
  • ensureDirExists (3-14)
scripts/utils/load-image-as-data-uri.ts (1)
  • loadImageAsDataUri (4-8)
scripts/utils/course-info.ts (1)
  • getCourseInfo (5-19)
scripts/utils/generate-courses-tree.ts (1)
  • createCourseTree (3-122)
scripts/utils/generate-image.tsx (1)
  • generateImage (6-32)
scripts/utils/generate-page-tree.ts (1)
  • createPageTree (3-130)
scripts/utils/generate-image.tsx (1)
scripts/utils/load-fonts.ts (1)
  • Font (4-9)
src/app/docs/[lang]/[...slug]/page.tsx (3)
src/app/layout.tsx (1)
  • metadata (11-36)
src/shared/helpers/generate-page-metadata.ts (1)
  • generatePageMetadata (1-26)
src/app/docs/constants.ts (1)
  • TITLE_POSTFIX (2-2)
πŸͺ› GitHub Actions: Pull Request
scripts/generate-og-script.ts

[error] 28-28: TypeError: Failed to parse URL from undefined. The error originates from an invalid URL input in fetchCoursesList function called at line 4 in fetch-courses-list.ts. This caused the build to fail with exit code 1.

πŸ”‡ Additional comments (40)
tsconfig.json (1)

56-58: Correctly updated the TypeScript configuration to include new script

The inclusion of "scripts/generate-og-script.ts" in the TypeScript configuration ensures proper type checking and compilation for the new OG image generation script.

scripts/types.ts (1)

1-4: Type definition looks good

The ApiCourse type correctly defines the expected structure with the necessary properties for course data handling.

.gitignore (1)

35-36: Good practice: ignoring generated OG image directories

The addition of generated OG image directories to .gitignore prevents unwanted version control of dynamically generated assets.

src/app/layout.tsx (1)

12-12: Remember to change this URL during local development

The metadataBase URL is set to the production URL. As mentioned in the PR description, developers will need to modify this to 'http://localhost:3000' during local development to ensure proper OG image rendering.

Ensure this is documented in the project README or development guide to help other developers.

src/app/courses/page.tsx (3)

3-3: Proper import added for metadata helper function

The import of generatePageMetadata enables consistent metadata generation across the site.


8-8: Great descriptive text for SEO

The description provides a concise summary that effectively captures the value proposition of the courses.


10-15: Good implementation of centralized metadata generation

Using the helper function ensures consistency across all pages and properly includes Open Graph image data for social sharing.

src/app/mentorship/page.tsx (3)

3-3: Proper import added for metadata helper function

The import aligns with the overall approach to centralize metadata generation.


9-9: Concise and engaging mentorship description

The description effectively communicates the reciprocal benefit of mentorship.


11-16: Consistent implementation of metadata generation

The helper function is properly used with all required parameters, maintaining consistent structure.

src/app/mentorship/[course]/page.tsx (1)

3-3: Proper import added for metadata helper function

The import matches the pattern used across other page components.

src/app/page.tsx (3)

3-3: Proper import added for metadata helper function

The import enables consistent metadata generation for the home page.


8-8: Effective and concise home page description

The description captures the community spirit of the school in a memorable way.


10-16: Proper implementation of metadata generation

The helper function is correctly used with all required parameters to generate complete metadata including Open Graph image data.

src/app/community/page.tsx (3)

3-3: New import added correctly.

The import for generatePageMetadata helper is properly added.


8-8: Good description for community page.

Clear, concise description that accurately represents the community page content.


10-16: Metadata implementation looks good.

The implementation correctly uses the new helper function with appropriate parameters:

  • Title from existing code
  • New description
  • Proper OG image path that follows the convention

This ensures consistent metadata structure across the site.

src/app/courses/nodejs/page.tsx (3)

3-3: New import added correctly.

The import for generatePageMetadata helper is properly added.


11-12: Good metadata implementation.

The title is correctly fetched asynchronously, and the Node.js course has a detailed, specific description.


14-20: Metadata generation looks good.

The implementation correctly uses the helper function with appropriate parameters:

  • Dynamic title
  • Specific course description
  • Proper OG image path following the naming convention

This ensures consistent metadata across course pages.

src/app/courses/reactjs/page.tsx (2)

3-3: New import added correctly.

The import for generatePageMetadata helper is properly added.


14-20: Metadata implementation is correct.

The helper function is used correctly with the appropriate parameters, ensuring consistent metadata structure.

src/app/docs/[lang]/page.tsx (2)

4-4: New import added correctly.

The import for generatePageMetadata helper is properly added.


10-19: Metadata implementation looks good.

The implementation correctly:

  • Uses the existing title with postfix
  • Adds a clear and concise description
  • References the appropriate OG image path
  • Uses the helper function consistently

This ensures standardized metadata structure across the site.

src/app/courses/javascript-preschool-ru/page.tsx (1)

3-3: Properly implemented Open Graph metadata

The metadata generation is correctly implemented using the new helper function. The course-specific description and image path provide good context for social sharing.

Also applies to: 11-20

src/app/courses/angular/page.tsx (1)

3-3: Well-implemented OG metadata

The metadata implementation follows the project's standard pattern and provides a clear description that accurately represents the Angular course.

Also applies to: 11-20

src/app/courses/aws-fundamentals/page.tsx (1)

3-3: Correctly implemented metadata

The AWS Fundamentals course metadata is properly implemented with a relevant description and appropriate image path.

Also applies to: 11-20

src/app/courses/javascript-ru/page.tsx (1)

10-21: Metadata implementation looks good

The implementation correctly uses the central generatePageMetadata helper to create consistent metadata across the site.

src/app/docs/[lang]/[...slug]/page.tsx (1)

48-56: Well-implemented metadata enhancement

The metadata generation follows the standardized pattern using the shared helper function.

scripts/utils/ensure-dir-exists.ts (1)

3-14: Well-implemented directory existence check

This utility function correctly handles directory creation with proper error handling.

The implementation:

  1. Properly checks if the directory exists
  2. Creates it recursively if needed
  3. Handles errors appropriately, distinguishing between missing directories and other errors
src/app/courses/aws-cloud-developer/page.tsx (2)

3-3: New import for metadata generation utility.

Good addition of the generatePageMetadata helper to standardize metadata generation.


11-20: Metadata implementation looks good.

The enhanced metadata implementation properly includes title, description, and OG image path, following the project's new metadata standard.

package.json (2)

7-9: Script integration for OG image generation.

Good implementation of pre-build OG image generation script that runs before both development and build processes.


95-95: Added tsx dependency.

Appropriate addition of the tsx package as a dev dependency to support the new OG image generation script.

dev-data/open-graph.data.ts (2)

1-11: Course slugs mapping looks good.

The course slugs mapping provides a clean way to reference course URLs.


13-20: Page mapping implementation.

Clear mapping of page identifiers to their display names.

src/app/courses/aws-devops/page.tsx (2)

3-3: New import for metadata generation utility.

Good addition of the generatePageMetadata helper to standardize metadata generation.


11-20: Metadata implementation looks good.

The enhanced metadata implementation properly includes title, description, and OG image path, following the project's new metadata standard.

src/shared/helpers/generate-page-metadata.ts (1)

1-26: Well-structured metadata generator

This function provides a clean, standardized way to generate page metadata including Open Graph properties. The structure matches Next.js metadata requirements and includes all essential fields for proper social media sharing.

scripts/utils/generate-image.tsx (1)

1-32: Robust image generation with proper error handling

The function correctly handles JSX-to-image conversion with appropriate input validation and error catching. The use of Buffer for the output makes it versatile for file system operations.

Comment on lines 14 to 21
style: {
display: 'flex',
width: 1200,
height: 630,
fontFamily: 'Inter',
weight: 400,
},
},
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Fix invalid CSS property in root element styles

The root div uses an invalid CSS property weight which should be fontWeight.

style: {
  display: 'flex',
  width: 1200,
  height: 630,
  fontFamily: 'Inter',
-  weight: 400,
+  fontWeight: 400,
},
πŸ“ Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
style: {
display: 'flex',
width: 1200,
height: 630,
fontFamily: 'Inter',
weight: 400,
},
},
style: {
display: 'flex',
width: 1200,
height: 630,
fontFamily: 'Inter',
fontWeight: 400,
},
},

Copy link

Lighthouse Report:

  • Performance: 79 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (3)
scripts/utils/get-courses-schedule.ts (3)

4-7: Consider adding JSDoc documentation.

This utility function would benefit from JSDoc documentation explaining its purpose, return type, and potential errors.

+/**
+ * Fetches course schedule data from the API
+ * @returns Array of course objects with startDate and descriptionUrl properties
+ * @throws Logs error and returns empty array if fetch fails
+ */
 export async function getCoursesSchedule() {
   try {
     const response = await api.course.queryCoursesSchedule();

7-8: Type assertion should be validated.

The type assertion (as CoursesScheduleResponse) doesn't validate the actual shape of the data. Consider using runtime validation or a more type-safe approach.

-    const courses = response.result as CoursesScheduleResponse;
+    // Option 1: Basic validation
+    const result = response.result;
+    if (!Array.isArray(result)) {
+      throw new Error('Invalid API response format');
+    }
+    const courses = result as CoursesScheduleResponse;
+    
+    // Option 2: With a validation library like zod, ajv, etc.
+    // import { courseScheduleSchema } from '../../path/to/validation';
+    // const courses = courseScheduleSchema.parse(response.result);

4-17: Consider dependency injection for better testability.

The current implementation directly imports the API client, making it difficult to test in isolation. Consider using dependency injection for better testability.

-export async function getCoursesSchedule() {
+export async function getCoursesSchedule(apiClient = api) {
   try {
-    const response = await api.course.queryCoursesSchedule();
+    const response = await apiClient.course.queryCoursesSchedule();
     const courses = response.result as CoursesScheduleResponse;
πŸ“œ Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between ab05327 and 181b67c.

πŸ“’ Files selected for processing (3)
  • scripts/generate-og-script.ts (1 hunks)
  • scripts/utils/course-info.ts (1 hunks)
  • scripts/utils/get-courses-schedule.ts (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • scripts/utils/course-info.ts
  • scripts/generate-og-script.ts
🧰 Additional context used
🧬 Code Graph Analysis (1)
scripts/utils/get-courses-schedule.ts (2)
src/shared/api/api.ts (1)
  • api (3-3)
src/entities/course/types.ts (1)
  • CoursesScheduleResponse (13-32)
πŸ”‡ Additional comments (3)
scripts/utils/get-courses-schedule.ts (3)

1-3: Appropriate imports for the utility.

The imports correctly reference the required type and API client needed for this utility function.


9-12: Appropriate data extraction logic.

The mapping logic correctly extracts the needed fields with fallbacks for missing values.


13-16: Error handling looks good.

The function appropriately catches errors, logs them, and returns a sensible fallback value.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 3

♻️ Duplicate comments (1)
scripts/generate-og-script.ts (1)

133-141: πŸ› οΈ Refactor suggestion

Use Promise.all for better error handling

Running tasks in parallel with separate error handlers can terminate the process before all tasks complete.

- generateOgImagePages().catch((err) => {
-   console.error(err);
-   process.exit(1);
- });
-
- generateOGCourses().catch((err) => {
-   console.error(err);
-   process.exit(1);
- });
+ Promise.all([generateOgImagePages(), generateOGCourses()])
+   .then(() => console.log('OG image generation finished βœ…'))
+   .catch((err) => {
+     console.error('OG image generation failed ❌', err);
+     process.exit(1);
+   });
🧹 Nitpick comments (3)
scripts/utils/courses-tree/generate-courses-tree.tsx (2)

5-12: Parameter naming could be clearer

The parameters rsLogoDataUriPromise and logoCourseUriPromise suggest they're Promises, but they're actually string values (already resolved data URIs).

export function createCourseTree(
  title: string,
  leftTitle: string,
  leftSubtitle: string,
  formattedDate: string,
-  rsLogoDataUriPromise: string,
-  logoCourseUriPromise: string,
+  rsLogoDataUri: string,
+  logoCourseDataUri: string,
): React.JSX.Element {

Corresponding changes should be made in the function body:

        <img
-          src={rsLogoDataUriPromise}
+          src={rsLogoDataUri}
          style={stylesCourseTree.logo}
          alt="RS School Logo"
        />
        
        <img
-          src={logoCourseUriPromise}
+          src={logoCourseDataUri}
          style={stylesCourseTree.courseLogo}
          alt={`${title} logo`}
        />

16-20: Improve accessibility with more descriptive alt text

The current alt text is generic. Consider adding more context for better accessibility.

        <img
          src={rsLogoDataUriPromise}
          style={stylesCourseTree.logo}
-          alt="RS School Logo"
+          alt="Rolling Scopes School Logo"
        />
scripts/generate-og-script.ts (1)

24-80: Inconsistent function naming

Function naming has inconsistent capitalization: generateOGCourses vs generateOgImagePages.

- async function generateOGCourses(): Promise<void> {
+ async function generateOgCourses(): Promise<void> {

Update references too:

- Promise.all([generateOgImagePages(), generateOGCourses()])
+ Promise.all([generateOgImagePages(), generateOgCourses()])
🧰 Tools
πŸͺ› GitHub Actions: Preview

[error] 57-57: Error: ENOENT: no such file or directory, open '/home/runner/work/site/site/src/shared/assets/og-logos/undefined.svg'. The file 'undefined.svg' is missing, causing the build script to fail.

πŸͺ› GitHub Actions: Pull Request

[error] 57-57: Error: ENOENT: no such file or directory, open '/home/runner/work/site/site/src/shared/assets/og-logos/undefined.svg'. The file 'undefined.svg' is missing, causing the build script to fail.

πŸ“œ Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between 181b67c and 5832416.

πŸ“’ Files selected for processing (3)
  • scripts/generate-og-script.ts (1 hunks)
  • scripts/utils/courses-tree/generate-courses-tree.styles.ts (1 hunks)
  • scripts/utils/courses-tree/generate-courses-tree.tsx (1 hunks)
βœ… Files skipped from review due to trivial changes (1)
  • scripts/utils/courses-tree/generate-courses-tree.styles.ts
🧰 Additional context used
πŸͺ› GitHub Actions: Preview
scripts/generate-og-script.ts

[error] 57-57: Error: ENOENT: no such file or directory, open '/home/runner/work/site/site/src/shared/assets/og-logos/undefined.svg'. The file 'undefined.svg' is missing, causing the build script to fail.

πŸͺ› GitHub Actions: Pull Request
scripts/generate-og-script.ts

[error] 57-57: Error: ENOENT: no such file or directory, open '/home/runner/work/site/site/src/shared/assets/og-logos/undefined.svg'. The file 'undefined.svg' is missing, causing the build script to fail.

πŸ”‡ Additional comments (2)
scripts/utils/courses-tree/generate-courses-tree.tsx (1)

1-35: Component looks good overall

The JSX structure is clean and well-organized. The component correctly uses the imported styles and creates a visually balanced layout for the Open Graph image.

scripts/generate-og-script.ts (1)

1-23: Script setup looks well-organized

The imports, font loading, and type definitions are well-structured and follow good practices.

Comment on lines 51 to 61
for (const key of Object.keys(COURSE_TITLES) as CourseKey[]) {
const slug: string = COURSE_SLUGS[key];
const title: string = COURSE_TITLES[key];

const formattedDate: string = getCourseInfo(coursesSchedule, slug);

const logoDataUri: string = await loadImageAsDataUri(
`src/shared/assets/og-logos/${slug}.svg`,
'image/svg+xml',
);

Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue

Handle undefined slug to prevent build failure

Pipeline failures show that the script is trying to access undefined.svg. You need to validate course slugs before using them.

  for (const key of Object.keys(COURSE_TITLES) as CourseKey[]) {
    const slug: string = COURSE_SLUGS[key];
+   if (!slug) {
+     console.warn(`Skipping OG image generation for ${key} - slug is undefined`);
+     continue;
+   }
    const title: string = COURSE_TITLES[key];

    const formattedDate: string = getCourseInfo(coursesSchedule, slug);

    const logoDataUri: string = await loadImageAsDataUri(
      `src/shared/assets/og-logos/${slug}.svg`,
      'image/svg+xml',
    );
πŸ“ Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
for (const key of Object.keys(COURSE_TITLES) as CourseKey[]) {
const slug: string = COURSE_SLUGS[key];
const title: string = COURSE_TITLES[key];
const formattedDate: string = getCourseInfo(coursesSchedule, slug);
const logoDataUri: string = await loadImageAsDataUri(
`src/shared/assets/og-logos/${slug}.svg`,
'image/svg+xml',
);
for (const key of Object.keys(COURSE_TITLES) as CourseKey[]) {
const slug: string = COURSE_SLUGS[key];
if (!slug) {
console.warn(`Skipping OG image generation for ${key} - slug is undefined`);
continue;
}
const title: string = COURSE_TITLES[key];
const formattedDate: string = getCourseInfo(coursesSchedule, slug);
const logoDataUri: string = await loadImageAsDataUri(
`src/shared/assets/og-logos/${slug}.svg`,
'image/svg+xml',
);
// …rest of your loop body…
}
🧰 Tools
πŸͺ› GitHub Actions: Preview

[error] 57-57: Error: ENOENT: no such file or directory, open '/home/runner/work/site/site/src/shared/assets/og-logos/undefined.svg'. The file 'undefined.svg' is missing, causing the build script to fail.

πŸͺ› GitHub Actions: Pull Request

[error] 57-57: Error: ENOENT: no such file or directory, open '/home/runner/work/site/site/src/shared/assets/og-logos/undefined.svg'. The file 'undefined.svg' is missing, causing the build script to fail.

πŸ€– Prompt for AI Agents
In scripts/generate-og-script.ts around lines 51 to 61, the code uses
COURSE_SLUGS[key] without checking if the slug is defined, causing build
failures when slug is undefined. Add a validation step after retrieving the slug
to check if it is defined; if not, skip processing that key or handle the error
gracefully to prevent accessing undefined.svg files.

Comment on lines 71 to 78
const buffer: Buffer<ArrayBufferLike> | null = await generateImage(tree, fonts);

if (!buffer) {
throw new Error(`Doesn't generate image for "${slug}"`);
}

await fs.writeFile(path.join(ogDir, `${slug}.png`), buffer);
console.log(`${slug} created`);
Copy link
Contributor

Choose a reason for hiding this comment

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

πŸ› οΈ Refactor suggestion

Add try-catch for image file operations

Missing error handling for image file operations could lead to unhandled exceptions.

    const buffer: Buffer<ArrayBufferLike> | null = await generateImage(tree, fonts);

    if (!buffer) {
      throw new Error(`Doesn't generate image for "${slug}"`);
    }

-   await fs.writeFile(path.join(ogDir, `${slug}.png`), buffer);
-   console.log(`${slug} created`);
+   try {
+     await fs.writeFile(path.join(ogDir, `${slug}.png`), buffer);
+     console.log(`${slug} created`);
+   } catch (error) {
+     console.error(`Error writing image file for ${slug}:`, error);
+     throw error;
+   }
πŸ“ Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
const buffer: Buffer<ArrayBufferLike> | null = await generateImage(tree, fonts);
if (!buffer) {
throw new Error(`Doesn't generate image for "${slug}"`);
}
await fs.writeFile(path.join(ogDir, `${slug}.png`), buffer);
console.log(`${slug} created`);
const buffer: Buffer<ArrayBufferLike> | null = await generateImage(tree, fonts);
if (!buffer) {
throw new Error(`Doesn't generate image for "${slug}"`);
}
try {
await fs.writeFile(path.join(ogDir, `${slug}.png`), buffer);
console.log(`${slug} created`);
} catch (error) {
console.error(`Error writing image file for ${slug}:`, error);
throw error;
}
πŸ€– Prompt for AI Agents
In scripts/generate-og-script.ts around lines 71 to 78, the image generation and
file writing operations lack error handling, which can cause unhandled
exceptions. Wrap the code that generates the image buffer and writes the file in
a try-catch block. In the catch block, log or handle the error appropriately to
prevent the script from crashing unexpectedly.

Comment on lines 122 to 130
const fileName: string = `${title.toLowerCase()}.png`.replace(/\s+/g, '-');

if (!buffer) {
throw new Error(`Doesn't generate image for "${title}"`);
}

await fs.writeFile(path.join(ogDir, fileName), buffer);
console.log(`${fileName} created`);
}
Copy link
Contributor

Choose a reason for hiding this comment

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

πŸ› οΈ Refactor suggestion

Similar error handling needed in page image generation

Apply the same error handling pattern here as suggested for course image generation.

    const buffer: Buffer<ArrayBufferLike> | null = await generateImage(tree, fonts);
    const fileName: string = `${title.toLowerCase()}.png`.replace(/\s+/g, '-');

    if (!buffer) {
      throw new Error(`Doesn't generate image for "${title}"`);
    }

-   await fs.writeFile(path.join(ogDir, fileName), buffer);
-   console.log(`${fileName} created`);
+   try {
+     await fs.writeFile(path.join(ogDir, fileName), buffer);
+     console.log(`${fileName} created`);
+   } catch (error) {
+     console.error(`Error writing image file for ${fileName}:`, error);
+     throw error;
+   }
πŸ“ Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
const fileName: string = `${title.toLowerCase()}.png`.replace(/\s+/g, '-');
if (!buffer) {
throw new Error(`Doesn't generate image for "${title}"`);
}
await fs.writeFile(path.join(ogDir, fileName), buffer);
console.log(`${fileName} created`);
}
const buffer: Buffer<ArrayBufferLike> | null = await generateImage(tree, fonts);
const fileName: string = `${title.toLowerCase()}.png`.replace(/\s+/g, '-');
if (!buffer) {
throw new Error(`Doesn't generate image for "${title}"`);
}
try {
await fs.writeFile(path.join(ogDir, fileName), buffer);
console.log(`${fileName} created`);
} catch (error) {
console.error(`Error writing image file for ${fileName}:`, error);
throw error;
}
}
πŸ€– Prompt for AI Agents
In scripts/generate-og-script.ts around lines 122 to 130, the error handling for
the image generation is missing proper checks similar to those used in course
image generation. Add a check to verify if the buffer is valid before attempting
to write the file, and if not, throw an error with a descriptive message
including the title. This ensures consistent and clear error handling for image
generation failures.

Copy link

Lighthouse Report:

  • Performance: 81 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link

Lighthouse Report:

  • Performance: 78 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🧹 Nitpick comments (3)
scripts/utils/load-fonts.ts (1)

34-34: Consider making the module more extensible.

The current implementation works well for the Inter font with two weights. For future extensibility, consider parameterizing the font name or allowing additional font weights.

scripts/view/courses-tree/generate-courses-tree.tsx (2)

7-7: Variable name could be more descriptive.

The rsStudentPromise name doesn't match what it's loading (the sloth mascot image).

-const rsStudentPromise = loadImageAsDataUri('src/shared/assets/rs-school.webp');
+const rsSchoolMascotPromise = loadImageAsDataUri('src/shared/assets/rs-school.webp');

24-24: Fix missing period for consistency.

The subtitle text has a period after "courses" but missing one after "motivation".

-        <p style={stylesCourseTree.subtitle}>Free courses. High motivation</p>
+        <p style={stylesCourseTree.subtitle}>Free courses. High motivation.</p>
πŸ“œ Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between d719bbe and 5e24bee.

πŸ“’ Files selected for processing (26)
  • .gitignore (1 hunks)
  • scripts/generate-og-script.ts (1 hunks)
  • scripts/shared/constants.ts (1 hunks)
  • scripts/types/types.ts (1 hunks)
  • scripts/utils/generate-image.tsx (1 hunks)
  • scripts/utils/get-combain-data-courses.ts (1 hunks)
  • scripts/utils/load-fonts.ts (1 hunks)
  • scripts/view/courses-tree/generate-courses-tree.tsx (1 hunks)
  • src/app/community/page.tsx (1 hunks)
  • src/app/courses/angular/page.tsx (1 hunks)
  • src/app/courses/aws-ai/page.tsx (1 hunks)
  • src/app/courses/aws-cloud-developer/page.tsx (1 hunks)
  • src/app/courses/aws-devops/page.tsx (1 hunks)
  • src/app/courses/aws-fundamentals/page.tsx (1 hunks)
  • src/app/courses/javascript-preschool-ru/page.tsx (1 hunks)
  • src/app/courses/javascript-ru/page.tsx (1 hunks)
  • src/app/courses/javascript/page.tsx (1 hunks)
  • src/app/courses/nodejs/page.tsx (1 hunks)
  • src/app/courses/page.tsx (1 hunks)
  • src/app/courses/reactjs/page.tsx (1 hunks)
  • src/app/docs/[lang]/[...slug]/page.tsx (2 hunks)
  • src/app/docs/[lang]/page.tsx (1 hunks)
  • src/app/mentorship/[course]/page.tsx (1 hunks)
  • src/app/mentorship/page.tsx (1 hunks)
  • src/app/page.tsx (1 hunks)
  • src/shared/constants.ts (1 hunks)
βœ… Files skipped from review due to trivial changes (3)
  • src/shared/constants.ts
  • scripts/shared/constants.ts
  • scripts/types/types.ts
🚧 Files skipped from review as they are similar to previous changes (21)
  • .gitignore
  • src/app/courses/javascript-preschool-ru/page.tsx
  • src/app/page.tsx
  • src/app/mentorship/[course]/page.tsx
  • src/app/courses/javascript-ru/page.tsx
  • src/app/docs/[lang]/page.tsx
  • src/app/courses/reactjs/page.tsx
  • src/app/courses/angular/page.tsx
  • src/app/docs/[lang]/[...slug]/page.tsx
  • src/app/courses/aws-ai/page.tsx
  • src/app/courses/aws-fundamentals/page.tsx
  • src/app/community/page.tsx
  • src/app/courses/aws-cloud-developer/page.tsx
  • src/app/courses/page.tsx
  • src/app/mentorship/page.tsx
  • src/app/courses/nodejs/page.tsx
  • src/app/courses/aws-devops/page.tsx
  • scripts/utils/generate-image.tsx
  • scripts/utils/get-combain-data-courses.ts
  • scripts/generate-og-script.ts
  • src/app/courses/javascript/page.tsx
🧰 Additional context used
🧬 Code Graph Analysis (1)
scripts/view/courses-tree/generate-courses-tree.tsx (3)
scripts/utils/load-image-as-data-uri.ts (1)
  • loadImageAsDataUri (5-21)
scripts/types/types.ts (1)
  • CourseData (3-9)
scripts/view/courses-tree/generate-courses-tree.styles.ts (1)
  • stylesCourseTree (1-69)
πŸ”‡ Additional comments (3)
scripts/utils/load-fonts.ts (2)

6-24: Good implementation with proper error handling.

The loadFont function is well-structured with appropriate error handling, which aligns with the previous review comments that were addressed.


26-32: Efficient parallel font loading.

Using separate promises with Promise.all for concurrent loading of font weights is an efficient approach.

scripts/view/courses-tree/generate-courses-tree.tsx (1)

15-36: Well-structured component with good use of styles.

The JSX layout is clear and well-organized, with proper separation between sections and appropriate styling.

Comment on lines +9 to +14
export async function createCourseTree(
course: CourseData,
): Promise<React.JSX.Element> {
const { name, logo, startDate } = course;
const rsStudentImg = await rsStudentPromise;

Copy link
Contributor

Choose a reason for hiding this comment

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

πŸ› οΈ Refactor suggestion

Add error handling for image loading.

The function awaits the promise but doesn't handle potential image loading errors.

export async function createCourseTree(
  course: CourseData,
): Promise<React.JSX.Element> {
  const { name, logo, startDate } = course;
-  const rsStudentImg = await rsStudentPromise;
+  let rsStudentImg;
+  try {
+    rsStudentImg = await rsStudentPromise;
+  } catch (error) {
+    console.error('Failed to load RS School mascot image:', error);
+    // Provide fallback or rethrow based on requirements
+    throw new Error('Failed to generate course tree image: mascot image loading failed');
+  }
πŸ“ Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
export async function createCourseTree(
course: CourseData,
): Promise<React.JSX.Element> {
const { name, logo, startDate } = course;
const rsStudentImg = await rsStudentPromise;
export async function createCourseTree(
course: CourseData,
): Promise<React.JSX.Element> {
const { name, logo, startDate } = course;
- const rsStudentImg = await rsStudentPromise;
+ let rsStudentImg;
+ try {
+ rsStudentImg = await rsStudentPromise;
+ } catch (error) {
+ console.error('Failed to load RS School mascot image:', error);
+ // Provide fallback or rethrow based on requirements
+ throw new Error('Failed to generate course tree image: mascot image loading failed');
+ }
// ...rest of the implementation
}
πŸ€– Prompt for AI Agents
In scripts/view/courses-tree/generate-courses-tree.tsx around lines 9 to 14, the
code awaits the rsStudentPromise for loading an image but lacks error handling.
Wrap the await call in a try-catch block to catch any errors during image
loading, and handle the error appropriately, such as logging the error or
providing a fallback image, to prevent unhandled promise rejections.

Copy link

Lighthouse Report:

  • Performance: 68 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link

Lighthouse Report:

  • Performance: 87 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

♻️ Duplicate comments (2)
scripts/generate-og-script.ts (2)

39-64: πŸ› οΈ Refactor suggestion

Add error handling for page file operations

Similar to the course generation, file operations for pages need proper error handling.

   if (!buffer) {
     throw new Error(`Doesn't generate image for "${page.title}"`);
   }

   const fileName: string =
     `${page.title.toLowerCase()}`
       .replace(/\s+/g, '-')
       .replace(/[^\w-]/g, '')
       .replace(/-+/g, '-') + '.png';

-  await fs.writeFile(path.join(ogDir, fileName), buffer);
-  console.log(`${fileName} created`);
+  try {
+    await fs.writeFile(path.join(ogDir, fileName), buffer);
+    console.log(`${fileName} created`);
+  } catch (error) {
+    console.error(`Error writing image file for ${fileName}:`, error);
+    throw error;
+  }

25-36: πŸ› οΈ Refactor suggestion

Add validation for course properties and error handling for file operations

Missing validation for course properties and try-catch blocks for file operations could lead to runtime errors.

 for (const course of courseLogos) {
+  if (!course.normalizeName || !course.logo) {
+    console.warn(`Skipping course with missing data: ${JSON.stringify(course)}`);
+    continue;
+  }
   const tree = await createCourseTree(course);

   const buffer: Buffer | null = await generateImage(tree, fonts);

   if (!buffer) {
     throw new Error(`Doesn't generate image for "${course.normalizeName}"`);
   }

-  await fs.writeFile(path.join(ogCoursesDir, `${course.normalizeName}.png`), buffer);
-  console.log(`${course.normalizeName} created`);
+  try {
+    await fs.writeFile(path.join(ogCoursesDir, `${course.normalizeName}.png`), buffer);
+    console.log(`${course.normalizeName} created`);
+  } catch (error) {
+    console.error(`Error writing image file for ${course.normalizeName}:`, error);
+    throw error;
+  }
🧹 Nitpick comments (1)
scripts/generate-og-script.ts (1)

66-75: Consider running image generation in parallel

The script currently runs the generators sequentially. For improved performance, consider using Promise.all.

 async function main() {
   try {
-    await generateOgImagePages();
-    await generateOgCourses();
+    await Promise.all([
+      generateOgImagePages(),
+      generateOgCourses()
+    ]);
     console.log('All Open Graph images generated successfully');
   } catch (err) {
     console.error('Error generating Open Graph images:', err);
     process.exit(1);
   }
 }
πŸ“œ Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between 5e24bee and a0e48b1.

πŸ“’ Files selected for processing (6)
  • scripts/generate-og-script.ts (1 hunks)
  • scripts/shared/constants.ts (1 hunks)
  • scripts/types/types.ts (1 hunks)
  • scripts/utils/generate-image.ts (1 hunks)
  • scripts/view/pages-tree/generate-pages-tree.tsx (1 hunks)
  • src/app/courses/javascript-preschool-ru/page.tsx (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • src/app/courses/javascript-preschool-ru/page.tsx
  • scripts/view/pages-tree/generate-pages-tree.tsx
🧰 Additional context used
🧬 Code Graph Analysis (2)
scripts/utils/generate-image.ts (2)
scripts/utils/load-fonts.ts (1)
  • fonts (34-34)
scripts/types/types.ts (1)
  • Font (18-23)
scripts/generate-og-script.ts (8)
src/shared/constants.ts (2)
  • OG_FOLDER (10-10)
  • OG_COURSES_FOLDER (11-11)
scripts/utils/ensure-dir-exists.ts (1)
  • ensureDirExists (3-14)
scripts/utils/get-combain-data-courses.ts (1)
  • getCombinedDataCourses (16-45)
scripts/view/courses-tree/generate-courses-tree.tsx (1)
  • createCourseTree (9-37)
scripts/utils/generate-image.ts (1)
  • generateImage (6-32)
scripts/utils/load-fonts.ts (1)
  • fonts (34-34)
scripts/shared/constants.ts (1)
  • RS_PAGES (1-13)
scripts/view/pages-tree/generate-pages-tree.tsx (1)
  • createPageTree (11-43)
πŸͺ› GitHub Check: CI
scripts/shared/constants.ts

[failure] 8-8:
Expected a line break before this closing brace


[failure] 8-8:
Object properties must go on a new line


[failure] 8-8:
Expected a line break after this opening brace


[failure] 7-7:
Expected a line break before this closing brace


[failure] 7-7:
Object properties must go on a new line


[failure] 7-7:
Expected a line break after this opening brace


[failure] 6-6:
Expected a line break before this closing brace


[failure] 6-6:
Object properties must go on a new line


[failure] 6-6:
Expected a line break after this opening brace

πŸͺ› GitHub Actions: Pull Request
scripts/shared/constants.ts

[error] 6-6: ESLint: Expected a line break after this opening brace (@stylistic/object-curly-newline)

πŸ”‡ Additional comments (2)
scripts/utils/generate-image.ts (1)

6-32: LGTM! Well-structured image generation utility

The function is well-implemented with proper error handling, input validation, and type safety.

scripts/types/types.ts (1)

1-23: LGTM! Clear and comprehensive type definitions

Types are well-structured and provide appropriate interfaces for course data, page metadata, and font resources.

Copy link

Lighthouse Report:

  • Performance: 68 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link

Lighthouse Report:

  • Performance: 68 / 100
  • Accessibility: 96 / 100
  • Best Practices: 100 / 100
  • SEO: 100 / 100

View detailed report

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (2)
scripts/api/get-combain-data-courses.ts (2)

1-4: File name contains a typo.

The filename "get-combain-data-courses.ts" contains a typo in "combain" which should be "combine".

-// File: scripts/api/get-combain-data-courses.ts
+// File: scripts/api/get-combine-data-courses.ts

Update all imports of this file accordingly.


16-45: Function name contains the same typo as the filename.

Function name should be "getCombinedDataCourses" instead of "getCombinedDataCourses". Also, the matching logic could be optimized for larger datasets.

Consider creating a lookup map for faster matching:

  try {
    const [coursesWithLogos, coursesWithDates] = await Promise.all([
      getCoursesLogo(),
      getCoursesSchedule(),
    ]);

+   // Create a map for faster lookups
+   const datesByUrl = new Map();
+   coursesWithDates.forEach(courseDate => {
+     const dateUrl = normalizeUrl(courseDate.descriptionUrl);
+     if (dateUrl) {
+       datesByUrl.set(dateUrl, courseDate);
+     }
+   });

    return coursesWithLogos
      .map((courseLogo) => {
        const logoUrl = normalizeUrl(courseLogo.url);
-       const matchedCourse = coursesWithDates.find((courseDate) => {
-         const logoUrl = normalizeUrl(courseLogo.url);
-         const dateUrl = normalizeUrl(courseDate.descriptionUrl);
-
-         return dateUrl && logoUrl && dateUrl === logoUrl;
-       });
+       const matchedCourse = logoUrl ? datesByUrl.get(logoUrl) : undefined;

        return {
          normalizeName: courseLogo.normalizeName,
          name: courseLogo.name,
          logo: courseLogo.logo,
          startDate: matchedCourse?.startDate || TO_BE_DETERMINED,
          url: courseLogo.url,
        };
      })
      .filter((course) => course.logo.src);
πŸ“œ Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
Cache: Disabled due to data retention organization setting
Knowledge Base: Disabled due to data retention organization setting

πŸ“₯ Commits

Reviewing files that changed from the base of the PR and between 76ee539 and b775830.

πŸ“’ Files selected for processing (4)
  • scripts/api/get-combain-data-courses.ts (1 hunks)
  • scripts/api/get-courses-logo.ts (1 hunks)
  • scripts/api/get-courses-schedule.ts (1 hunks)
  • scripts/generate-og-script.ts (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • scripts/generate-og-script.ts
🧰 Additional context used
🧬 Code Graph Analysis (2)
scripts/api/get-courses-schedule.ts (2)
src/shared/api/api.ts (1)
  • api (3-3)
src/entities/course/types.ts (1)
  • CoursesScheduleResponse (13-32)
scripts/api/get-combain-data-courses.ts (4)
scripts/types/types.ts (1)
  • CourseData (3-9)
scripts/api/get-courses-logo.ts (1)
  • getCoursesLogo (17-57)
scripts/api/get-courses-schedule.ts (1)
  • getCoursesSchedule (6-26)
src/shared/constants.ts (1)
  • TO_BE_DETERMINED (6-6)
πŸ”‡ Additional comments (4)
scripts/api/get-courses-schedule.ts (1)

1-26: Good implementation of course schedule fetching.

This function effectively fetches and formats course schedule data. The error handling is appropriate, returning an empty array on failure. Consider using more specific error types or adding more details to the error log to aid debugging.

scripts/api/get-courses-logo.ts (2)

7-15: Well-implemented name normalization function.

The function properly transforms course names into URL-friendly strings by handling spaces, special characters, and edge cases.


17-57: Robust implementation for retrieving course logos.

The function properly fetches courses, extracts logo data, and handles errors gracefully. The filtering at line 52 ensures only courses with valid logos are returned.

scripts/api/get-combain-data-courses.ts (1)

6-14: Good URL normalization function.

The function effectively normalizes URLs by removing protocol, www prefix, and trailing slashes, making comparisons more reliable.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add Open Graph Previews and Proper Meta Descriptions
4 participants