create-ej-app 1.0.0

package/template/src/components/user-account-nav.tsx

@@ -0,0 +1,60 @@
+'use client'
+
+import { User } from 'next-auth'
+import { signOut } from 'next-auth/react'
+import Link from 'next/link'
+import { FC, HTMLAttributes } from 'react'
+
+import {
+  DropdownMenu,
+  DropdownMenuContent,
+  DropdownMenuItem,
+  DropdownMenuSeparator,
+  DropdownMenuTrigger
+} from '@/components/ui/dropdown-menu'
+import { UserAvatar } from '@/components/user-avatar'
+
+interface UserAccountNavProps extends HTMLAttributes<HTMLDivElement> {
+  user: Pick<User, 'name' | 'image' | 'email'>
+}
+
+export const UserAccountNav: FC<UserAccountNavProps> = ({ user }) => {
+  return (
+    <DropdownMenu>
+      <DropdownMenuTrigger>
+        <UserAvatar
+          user={{ name: user.name || null, image: user.image || null }}
+          className="h-8 w-8"
+        />
+      </DropdownMenuTrigger>
+      <DropdownMenuContent align="end">
+        <div className="flex items-center justify-start gap-2 p-2">
+          <div className="flex flex-col space-y-1 leading-none">
+            {user.name && <p className="font-medium">{user.name}</p>}
+            {user.email && (
+              <p className="w-[200px] truncate text-sm text-muted-foreground">
+                {user.email}
+              </p>
+            )}
+          </div>
+        </div>
+        <DropdownMenuSeparator />
+        <DropdownMenuItem asChild>
+          <Link href="/settings">Settings</Link>
+        </DropdownMenuItem>
+        <DropdownMenuSeparator />
+        <DropdownMenuItem
+          className="cursor-pointer"
+          onSelect={event => {
+            event.preventDefault()
+            signOut({
+              callbackUrl: `${window.location.origin}/login`
+            })
+          }}
+        >
+          Sign out
+        </DropdownMenuItem>
+      </DropdownMenuContent>
+    </DropdownMenu>
+  )
+}

package/template/src/components/user-avatar.tsx

@@ -0,0 +1,25 @@
+import { User } from '@prisma/client'
+import { AvatarProps } from '@radix-ui/react-avatar'
+import { FC } from 'react'
+
+import { Icons } from '@/components/icons'
+import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar'
+
+interface UserAvatarProps extends AvatarProps {
+  user: Pick<User, 'image' | 'name'>
+}
+
+export const UserAvatar: FC<UserAvatarProps> = ({ user, ...props }) => {
+  return (
+    <Avatar {...props}>
+      {user.image ? (
+        <AvatarImage alt="Picture" src={user.image} />
+      ) : (
+        <AvatarFallback>
+          <span className="sr-only">{user.name}</span>
+          <Icons.user className="h-4 w-4" />
+        </AvatarFallback>
+      )}
+    </Avatar>
+  )
+}

package/template/src/env.mjs

@@ -0,0 +1,67 @@
+import { createEnv } from '@t3-oss/env-nextjs'
+import { z } from 'zod'
+
+export const env = createEnv({
+  /**
+   * Specify your server-side environment variables schema here. This way you can ensure the app
+   * isn't built with invalid env vars.
+   */
+  server: {
+    NODE_ENV: z.enum(['development', 'test', 'production']),
+    DATABASE_URL: z.string().url(),
+    NEXTAUTH_SECRET:
+      process.env.NODE_ENV === 'production'
+        ? z.string().min(1)
+        : z.string().min(1).optional(),
+    NEXTAUTH_URL: z.preprocess(
+      // This makes Vercel deployments not fail if you don't set NEXTAUTH_URL
+      // Since NextAuth.js automatically uses the VERCEL_URL if present.
+      str => process.env.VERCEL_URL ?? str,
+      // VERCEL_URL doesn't include `https` so it cant be validated as a URL
+      process.env.VERCEL ? z.string().min(1) : z.string().url()
+    ),
+    EMAIL_SERVER_HOST: z.string().min(1),
+    EMAIL_SERVER_PORT: z.number(),
+    EMAIL_SERVER_USER: z.string().min(1),
+    EMAIL_SERVER_PASSWORD: z.string().min(1),
+    EMAIL_FROM: z.string().email(),
+    GOOGLE_ID: z.string().min(1),
+    GOOGLE_SECRET: z.string().min(1),
+    GITHUB_ID: z.string().min(1),
+    GITHUB_SECRET: z.string().min(1)
+  },
+
+  /**
+   * Specify your client-side environment variables schema here. This way you can ensure the app
+   * isn't built with invalid env vars. To expose them to the client, prefix them with
+   * `NEXT_PUBLIC_`.
+   */
+  client: {
+    // NEXT_PUBLIC_CLIENTVAR: z.string().min(1),
+  },
+
+  /**
+   * You can't destruct `process.env` as a regular object in the Next.js edge runtimes (e.g.
+   * middlewares) or client-side so we need to destruct manually.
+   */
+  runtimeEnv: {
+    NODE_ENV: process.env.NODE_ENV,
+    DATABASE_URL: process.env.DATABASE_URL,
+    NEXTAUTH_SECRET: process.env.NEXTAUTH_SECRET,
+    NEXTAUTH_URL: process.env.NEXTAUTH_URL,
+    EMAIL_SERVER_HOST: process.env.EMAIL_SERVER_HOST,
+    EMAIL_SERVER_PORT: parseInt(process.env.EMAIL_SERVER_PORT || ''),
+    EMAIL_SERVER_USER: process.env.EMAIL_SERVER_USER,
+    EMAIL_SERVER_PASSWORD: process.env.EMAIL_SERVER_PASSWORD,
+    EMAIL_FROM: process.env.EMAIL_FROM,
+    GOOGLE_ID: process.env.GOOGLE_ID,
+    GOOGLE_SECRET: process.env.GOOGLE_SECRET,
+    GITHUB_ID: process.env.GITHUB_ID,
+    GITHUB_SECRET: process.env.GITHUB_SECRET
+  },
+  /**
+   * Run `build` or `dev` with `SKIP_ENV_VALIDATION` to skip env validation.
+   * This is especially useful for Docker builds.
+   */
+  skipValidation: !!process.env.SKIP_ENV_VALIDATION
+})

package/template/src/hooks/use-debounce.ts

@@ -0,0 +1,17 @@
+'use client'
+
+import { useEffect, useState } from 'react'
+
+export function useDebounce<T>(value: T, delay?: number): T {
+  const [debouncedValue, setDebouncedValue] = useState<T>(value)
+
+  useEffect(() => {
+    const timer = setTimeout(() => setDebouncedValue(value), delay || 500)
+
+    return () => {
+      clearTimeout(timer)
+    }
+  }, [value, delay])
+
+  return debouncedValue
+}

package/template/src/hooks/use-lock-body.tsx

@@ -0,0 +1,12 @@
+import { useLayoutEffect } from 'react'
+
+// @see https://usehooks.com/useLockBodyScroll.
+export function useLockBody() {
+  useLayoutEffect((): (() => void) => {
+    const originalStyle: string = window.getComputedStyle(
+      document.body
+    ).overflow
+    document.body.style.overflow = 'hidden'
+    return () => (document.body.style.overflow = originalStyle)
+  }, [])
+}

package/template/src/lib/auth.ts

@@ -0,0 +1,183 @@
+import { PrismaAdapter } from '@next-auth/prisma-adapter'
+import { Permissions, UserType } from '@prisma/client'
+import {
+  Session,
+  getServerSession,
+  type DefaultSession,
+  type NextAuthOptions
+} from 'next-auth'
+import EmailProvider from 'next-auth/providers/email'
+import GitHubProvider from 'next-auth/providers/github'
+import GoogleProvider from 'next-auth/providers/google'
+
+import { env } from '@/env.mjs'
+import { prisma } from '@/lib/db'
+
+/**
+ * Module augmentation for `next-auth` types. Allows us to add custom properties to the `session`
+ * object and keep type safety.
+ *
+ * @see https://next-auth.js.org/getting-started/typescript#module-augmentation
+ */
+declare module 'next-auth' {
+  interface Session extends DefaultSession {
+    user: {
+      id: string
+      type: UserType
+      roleId?: string | null
+    } & DefaultSession['user']
+  }
+
+  interface User {
+    type: UserType
+    roleId?: string | null
+  }
+}
+
+/**
+ * Options for NextAuth.js used to configure adapters, providers, callbacks, etc.
+ *
+ * @see https://next-auth.js.org/configuration/options
+ */
+export const authOptions: NextAuthOptions = {
+  pages: {
+    signIn: '/login'
+  },
+  callbacks: {
+    session({ session, user }) {
+      return {
+        ...session,
+        user: {
+          ...session.user,
+          id: user.id,
+          type: user.type,
+          roleId: user.roleId
+        }
+      }
+    }
+  },
+  adapter: PrismaAdapter(prisma),
+  providers: [
+    EmailProvider({
+      server: {
+        host: env.EMAIL_SERVER_HOST,
+        port: env.EMAIL_SERVER_PORT,
+        auth: {
+          user: env.EMAIL_SERVER_USER,
+          pass: env.EMAIL_SERVER_PASSWORD
+        }
+      },
+      from: env.EMAIL_FROM
+    }),
+    GoogleProvider({
+      clientId: env.GOOGLE_ID,
+      clientSecret: env.GOOGLE_SECRET
+    }),
+    GitHubProvider({
+      clientId: env.GITHUB_ID,
+      clientSecret: env.GITHUB_SECRET
+    })
+  ]
+}
+
+/**
+ * Wrapper for `getServerSession` so that you don't need to import the `authOptions` in every file.
+ *
+ * @see https://next-auth.js.org/configuration/nextjs
+ */
+export const getAuthSession = () => getServerSession(authOptions)
+
+export const authGuard = async (
+  types?: UserType | UserType[],
+  permission?: Permissions,
+  session?: Session
+) => {
+  if (!session) {
+    const tempSession = await getAuthSession()
+    if (!tempSession) return false
+    session = tempSession
+  }
+
+  if (session.user.type === 'Root') return session
+
+  if (types) {
+    if (Array.isArray(types)) {
+      if (!types.includes(session.user.type)) return false
+    } else {
+      if (types !== session.user.type) return false
+    }
+  }
+
+  if (!session.user.roleId || !permission) return false
+
+  const c = await prisma.rolePermission.count({
+    where: {
+      roleId: session.user.roleId,
+      permission
+    }
+  })
+  if (!c) return false
+
+  return session
+}
+
+export const checkForPermission = async (
+  permission: Permissions,
+  session?: Session
+) => {
+  if (!session) {
+    const tempSession = await getAuthSession()
+    if (!tempSession) return false
+    session = tempSession
+  }
+
+  if (session.user.type === 'Root') return true
+  if (!session.user.roleId) return false
+
+  const c = await prisma.rolePermission.count({
+    where: {
+      roleId: session.user.roleId,
+      permission
+    }
+  })
+
+  return !!c
+}
+
+export const getAuthSessionWithPermissions = async () => {
+  const session = await getAuthSession()
+
+  if (session && session.user) {
+    if (session.user.type === 'Root') {
+      return {
+        session,
+        permissions: ['*']
+      }
+    } else if (session.user.roleId) {
+      const permissions = await prisma.rolePermission.findMany({
+        where: {
+          roleId: session.user.roleId
+        },
+        select: {
+          permission: true
+        },
+        orderBy: {
+          permission: 'asc'
+        }
+      })
+      return {
+        session,
+        permissions: permissions.map(p => p.permission)
+      }
+    } else {
+      return {
+        session,
+        permissions: []
+      }
+    }
+  }
+
+  return {
+    session
+  }
+}

package/template/src/lib/cn.ts

@@ -0,0 +1,4 @@
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export const cn = (...inputs: ClassValue[]) => twMerge(clsx(inputs))

package/template/src/lib/db.ts

@@ -0,0 +1,20 @@
+import { PrismaClient } from '@prisma/client'
+
+import { env } from '@/env.mjs'
+
+const globalForPrisma = globalThis as unknown as {
+  prisma: PrismaClient | undefined
+}
+
+export const prisma =
+  globalForPrisma.prisma ||
+  new PrismaClient({
+    log:
+      env.NODE_ENV === 'development'
+        ? [
+            // 'info', 'query', 'error', 'warn'
+          ]
+        : ['error']
+  })
+
+if (env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma

package/template/src/lib/delay.ts

@@ -0,0 +1,2 @@
+export const delay = (ms: number) =>
+  new Promise(resolve => setTimeout(resolve, ms))

package/template/src/lib/formatDate.ts

@@ -0,0 +1,11 @@
+import dayjs from 'dayjs'
+import relativeTime from 'dayjs/plugin/relativeTime'
+
+dayjs.extend(relativeTime)
+
+export const formatDate = (date: Date) => dayjs(date).format('DD/MM/YYYY')
+
+export const formatDateTime = (date: Date) =>
+  dayjs(date).format('DD/MM/YYYY hh:mm:ss A')
+
+export const timesAgo = (date: Date) => dayjs(date).fromNow()

package/template/src/lib/generateLabel.ts

@@ -0,0 +1,5 @@
+export const generateLabel = (str: string) =>
+  str
+    .replaceAll('_', ' ')
+    .replaceAll(/([A-Z])/g, ' $1')
+    .trim()

package/template/src/lib/siteConfig.ts

@@ -0,0 +1,4 @@
+export const siteConfig = {
+  name: 'Project Name',
+  description: 'Project Description'
+}

package/template/src/types/UnwrapPromise.ts

@@ -0,0 +1 @@
+export type UnwrapPromise<T> = T extends Promise<infer U> ? U : T

package/template/tailwind.config.ts

@@ -0,0 +1,79 @@
+import type { Config } from 'tailwindcss'
+
+const tailwindConfig: Config = {
+  darkMode: ['class'],
+  content: ['./src/**/*.{js,ts,jsx,tsx,mdx}'],
+  theme: {
+    container: {
+      center: true,
+      padding: '2rem',
+      screens: {
+        '2xl': '1400px'
+      }
+    },
+    extend: {
+      backgroundImage: {
+        'gradient-radial': 'radial-gradient(var(--tw-gradient-stops))',
+        'gradient-conic':
+          'conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))'
+      },
+      colors: {
+        border: 'hsl(var(--border))',
+        input: 'hsl(var(--input))',
+        ring: 'hsl(var(--ring))',
+        background: 'hsl(var(--background))',
+        foreground: 'hsl(var(--foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--primary))',
+          foreground: 'hsl(var(--primary-foreground))'
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--secondary))',
+          foreground: 'hsl(var(--secondary-foreground))'
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--destructive))',
+          foreground: 'hsl(var(--destructive-foreground))'
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--muted))',
+          foreground: 'hsl(var(--muted-foreground))'
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--accent))',
+          foreground: 'hsl(var(--accent-foreground))'
+        },
+        popover: {
+          DEFAULT: 'hsl(var(--popover))',
+          foreground: 'hsl(var(--popover-foreground))'
+        },
+        card: {
+          DEFAULT: 'hsl(var(--card))',
+          foreground: 'hsl(var(--card-foreground))'
+        }
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)'
+      },
+      keyframes: {
+        'accordion-down': {
+          from: { height: '0' },
+          to: { height: 'var(--radix-accordion-content-height)' }
+        },
+        'accordion-up': {
+          from: { height: 'var(--radix-accordion-content-height)' },
+          to: { height: '0' }
+        }
+      },
+      animation: {
+        'accordion-down': 'accordion-down 0.2s ease-out',
+        'accordion-up': 'accordion-up 0.2s ease-out'
+      }
+    }
+  },
+  plugins: [require('tailwindcss-animate')]
+}
+
+module.exports = tailwindConfig

package/template/tsconfig.json

@@ -0,0 +1,46 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["DOM", "DOM.Iterable", "ESNext"],
+    "allowJs": true,
+    "checkJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "noImplicitThis": true,
+    "noUncheckedIndexedAccess": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    ".eslintrc.cjs",
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    "**/*.cjs",
+    "**/*.mjs",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}