draft: add supporters mechanism and new home page

Author: ovflowd

apps/site/components/Common/NodejsLogo/index.tsx

@@ -1,16 +1,16 @@
-import type { FC } from 'react';
+import type { ComponentProps, FC } from 'react';
 
 import Nodejs from '@/components/Icons/Logos/Nodejs';
 import type { LogoVariant } from '@/types';
 
 import style from './index.module.css';
 
-type NodejsLogoProps = {
+type NodejsLogoProps = ComponentProps<typeof Nodejs> & {
   variant?: LogoVariant;
 };
 
-const NodejsLogo: FC<NodejsLogoProps> = ({ variant = 'default' }) => (
-  <Nodejs variant={variant} className={style.nodejsLogo} />
+const NodejsLogo: FC<NodejsLogoProps> = ({ variant = 'default', ...props }) => (
+  <Nodejs variant={variant} className={style.nodejsLogo} {...props} />
 );
 
 export default NodejsLogo;

apps/site/components/Common/Supporters/SupporterIcon/index.tsx

@@ -0,0 +1,24 @@
+import Link from 'next/link';
+import { cloneElement, type ComponentProps, type FC } from 'react';
+
+import Skeleton from '@/components/Common/Skeleton';
+import type { Supporter } from '@/types';
+
+type SupporterIconProps = Supporter & ComponentProps<typeof Skeleton>;
+
+const SupporterIcon: FC<SupporterIconProps> = ({
+  name,
+  href,
+  icon,
+  loading = false,
+}) => (
+  <Skeleton loading={loading}>
+    <Link href={href} aria-label={name}>
+      {cloneElement(icon, {
+        className: 'h-12 w-12 rounded-lg bg-neutral-100 p-1',
+      })}
+    </Link>
+  </Skeleton>
+);
+
+export default SupporterIcon;

apps/site/components/Common/Supporters/SupporterIconList/index.tsx

@@ -0,0 +1,65 @@
+'use client';
+
+import { useEffect, useRef, useState, type FC } from 'react';
+
+import SupporterIcon from '@/components/Common/Supporters/SupporterIcon';
+import { randomSupporterList } from '@/components/Common/Supporters/utils';
+import { DEFAULT_SUPPORTERS_LIST } from '@/next.supporters.constants';
+import type { Supporter } from '@/types';
+
+type SupporterIconListProps = {
+  supporters: Array<Supporter>;
+  maxLength?: number;
+};
+
+const SupporterIconList: FC<SupporterIconListProps> = ({
+  supporters,
+  maxLength = 4,
+}) => {
+  const initialRenderer = useRef(true);
+
+  const [seedList, setSeedList] = useState<Array<Supporter>>(
+    DEFAULT_SUPPORTERS_LIST
+  );
+
+  useEffect(() => {
+    // We intentionally render the initial default "mock" list of sponsors
+    // to have the Skeletons loading, and then we render the actual list
+    // after an enough amount of time has passed to give a proper sense of Animation
+    // We do this client-side effect, to ensure that a random-amount of sponsors is renderered
+    // on every page load. Since our page is natively static, we need to ensure that
+    // on the client-side we have a random amount of sponsors rendered.
+    // Although whilst we are deployed on Vercel or other environment that supports ISR
+    // (Incremental Static Generation) whose would invalidate the cache every 5 minutes
+    // We want to ensure that this feature is compatible on a full-static environment
+    const renderSponsorsAnimation = setTimeout(() => {
+      initialRenderer.current = false;
+
+      setSeedList(
+        randomSupporterList(
+          supporters,
+          Math.max(supporters.length, maxLength * 2)
+        )
+      );
+    }, 1000);
+
+    return () => clearTimeout(renderSponsorsAnimation);
+    // We only want this to run once on initial render
+    // We don't really care if the props change as realistically they shouldn't ever
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  return (
+    <div className="flex flex-row flex-wrap items-center justify-center gap-4">
+      {seedList.slice(0, maxLength).map((supporter, index) => (
+        <SupporterIcon
+          {...supporter}
+          loading={initialRenderer.current}
+          key={index}
+        />
+      ))}
+    </div>
+  );
+};
+
+export default SupporterIconList;

apps/site/components/Common/Supporters/SupporterLogo/index.tsx

@@ -0,0 +1,9 @@
+import type { FC } from 'react';
+
+import type { Supporter } from '@/types';
+
+// @TODO: This will be used within the MDX page for Supporters
+// to render the Logos of Supporters in the page
+const SupporterLogo: FC<Supporter> = () => null;
+
+export default SupporterLogo;

apps/site/components/Common/Supporters/SupporterLogoList/index.tsx

@@ -0,0 +1,14 @@
+import type { FC } from 'react';
+
+import type { Supporter } from '@/types';
+
+type SupporterLogoListProps = {
+  supporters: Array<Supporter>;
+};
+
+// @TODO: This will be used within the MDX page for Supporters
+// to render the Logos of Supporters in the page
+// in a grid format that renders logo biggers based on thresholds
+const SupporterLogoList: FC<SupporterLogoListProps> = () => null;
+
+export default SupporterLogoList;

apps/site/components/Common/Supporters/utils.ts

@@ -0,0 +1,10 @@
+import type { Supporter } from '@/types';
+
+export const randomSupporterList = (
+  supporters: Array<Supporter>,
+  pick: number
+) =>
+  supporters
+    .sort(() => 0.5 - Math.random())
+    .slice(0, pick)
+    .sort((a, b) => b.threshold - a.threshold);

apps/site/components/Containers/Footer/index.tsx

@@ -8,7 +8,7 @@ import LinkedIn from '@/components/Icons/Social/LinkedIn';
 import Mastodon from '@/components/Icons/Social/Mastodon';
 import Slack from '@/components/Icons/Social/Slack';
 import Twitter from '@/components/Icons/Social/Twitter';
-import { siteNavigation } from '@/next.json.mjs';
+import type { FooterConfig, SocialConfig } from '@/types';
 
 import styles from './index.module.css';
 
@@ -21,15 +21,20 @@ const footerSocialIcons: Record<string, React.FC<SVGProps<SVGSVGElement>>> = {
   bluesky: Bluesky,
 };
 
-const Footer: FC = () => {
+type FooterProps = {
+  socialLinks: Array<SocialConfig>;
+  footerLinks: Array<FooterConfig>;
+};
+
+const Footer: FC<FooterProps> = ({ socialLinks, footerLinks }) => {
   const t = useTranslations();
 
-  const openJSlink = siteNavigation.footerLinks.at(-1)!;
+  const openJSlink = footerLinks.at(-1)!;
 
   return (
     <footer className={styles.footer}>
       <div className={styles.sectionPrimary}>
-        {siteNavigation.footerLinks.slice(0, -1).map(item => (
+        {footerLinks.slice(0, -1).map(item => (
           <NavItem type="footer" href={item.link} key={item.link}>
             {t(item.text)}
           </NavItem>
@@ -42,7 +47,7 @@ const Footer: FC = () => {
         </NavItem>
 
         <div className={styles.social}>
-          {siteNavigation.socialLinks.map(link => {
+          {socialLinks.map(link => {
             const SocialIcon = footerSocialIcons[link.icon];
 
             return (