Utilities & Helpers

Core Utilities

File: src/lib/utils.ts (12.6KB)

Class Utilities

cn(...inputs)              // clsx + tailwind-merge for className composition

String Utilities

getInitials(name)          // "John Doe" → "JD"
generateId()               // Random ID string

Date/Time Utilities

timeAgo(timestamp)         // "2 hours ago"
timeAgoShort(timestamp)    // "2h"
timeAgoDate(timestamp)     // Formatted date string
formatDate(date)           // Formatted date
formatRelativeTime(date)   // Human-readable time difference
formatWorkHours(hours)     // Work schedule string

Chat/Mention Utilities

extractMentions(text)               // Parse @mentions from text
setMentionsToNotification(text)     // Convert mentions for notifications
getLengthComments(activities)       // Count comments in activity array

Task Utilities

sortTasks(tasks, sortBy)    // Sort by priority/date/assignees

Security Utilities

checkPasswordStrength(password)   // 0-100 strength score
checkUsernameExists(username)     // Validate against Firestore

CSS Utilities

getTransformStyle(scale, position) // Generate CSS transform

Route Guards

Location: src/lib/utils/guards/

checkRegistrationApproved

// Returns boolean - checks user.registrationApproved === true
// Used in CustomGuard to gate app access during private beta
import { checkRegistrationApproved } from '$lib/utils/guards/check-registration-approved';

checkOnboardingCompleted

// Returns boolean - checks user.onboardingCompleted === true
// Enforces onboarding completion before app access
import { checkOnboardingCompleted } from '$lib/utils/guards/check-onboarding-completed';

Both guards use firekitDoc() with server-side reads for latest data.

Mobile Detection Hook

File: src/lib/hooks/is-mobile.svelte.ts

import { IsMobile } from '$lib/hooks/is-mobile.svelte';

// Uses MediaQuery with 768px breakpoint
const isMobile = new IsMobile();
// isMobile.matches → boolean

Reference Data

Location: src/lib/data/

File	Content	Count
countries.ts	Country objects with flag emojis, codes, default languages	249+
languages.ts	Languages with native names, English names, flag emojis	100+
timezones.ts	Timezones with offset, abbreviation, UTC city mappings	150+
pricing.ts	Plan pricing (Free/Standard/Elite)	3 plans
billing.ts	Billing/subscription data types	-
service-categories.ts	Service marketplace category taxonomy	-
navbar-categories.ts	Navigation category definitions	-
countries-card.ts	Card-formatted country data	-

App Configuration

File: src/lib/config.ts

const siteConfig = {
  title: 'Mindhyv',
  description: 'Change the Way You Work',
  logo: '/logo.svg',
  logoDark: '/logo-white.svg',
  favicon: '/favicon.png',
};

// Navigation groups
const navMain = [
  // Dashboard, Profile, Sites (/hubs), Chat (/connect),
  // Tasks (/hyvflow), Docs, Refer and Earn
];

const userNav = [
  // Upgrade to Elite, Account, Billing
];

const hubNav = [
  // Dashboard, Builder, Business Tools, Media,
  // Settings (Brand, Domain, Payments, Theme)
];