@tuturuuu/utils 0.13.0 → 0.15.1

package/CHANGELOG.md

@@ -1,5 +1,69 @@
 # Changelog
 
+## [0.15.1](https://github.com/tutur3u/platform/compare/utils-v0.15.0...utils-v0.15.1) (2026-07-13)
+
+
+### Bug Fixes
+
+* **contacts:** restore group post mutations ([fe621e4](https://github.com/tutur3u/platform/commit/fe621e4d7e4126f705082cc3e815aafdeebe535a))
+* **security:** prevent clickjacking across apps ([c8ed36e](https://github.com/tutur3u/platform/commit/c8ed36e708c08ebe3b17ee7f6249513644108c48))
+
+## [0.15.0](https://github.com/tutur3u/platform/compare/utils-v0.14.0...utils-v0.15.0) (2026-07-11)
+
+
+### Features
+
+* **contacts:** migrate users attendance; add satellite-safe workspace-user link helper ([8f53453](https://github.com/tutur3u/platform/commit/8f534533793af8d25e7c2eca6e0147e459d78bbe))
+* **contacts:** migrate users topic-announcements module ([01e19ab](https://github.com/tutur3u/platform/commit/01e19ab60461ccd94a0374bed74ce6e4d5d38a3b))
+* **contacts:** scaffold contacts.tuturuuu.com satellite shell + monorepo registration ([7e335fc](https://github.com/tutur3u/platform/commit/7e335fc036c4a45ed189095ecd10a43ee002294b))
+* **infrastructure:** add abuse protection controls ([0e09692](https://github.com/tutur3u/platform/commit/0e09692a553cb10fbbb521e921951c2a6863281d))
+* **infrastructure:** add rate-limit appeals ([f1e50e9](https://github.com/tutur3u/platform/commit/f1e50e9fd805dca6c80da8daab60ed24199f24ab))
+* **pay:** scaffold apps/pay satellite (pay.tuturuuu.com, port 7826) ([3d6e45c](https://github.com/tutur3u/platform/commit/3d6e45cca6a315fe67213e438144b73103bae2f5))
+* **tools:** add apps/tools public tools app, remove apps/qr ([204aae8](https://github.com/tutur3u/platform/commit/204aae89a04b4163f2859561f8e832526642e271))
+
+
+### Bug Fixes
+
+* **auth:** share account preference cookies ([8c1848a](https://github.com/tutur3u/platform/commit/8c1848a941c1b3f91337104c975e4bc0d8f68fc9))
+* **ci:** keep cache components enabled in production ([75e6e2b](https://github.com/tutur3u/platform/commit/75e6e2bbbf6fa432bc496ee95b75ade5f8847f9f))
+* **cli:** preserve markdown tables in task descriptions ([9faf8ba](https://github.com/tutur3u/platform/commit/9faf8ba44b92565a9dfc2949c496654fc1fea9b3))
+* **infrastructure:** default docker web to native builds ([7d89f00](https://github.com/tutur3u/platform/commit/7d89f004f75ab12eddc3cb92df5a1e6a7255fe0d))
+* **infrastructure:** restore canonical auth host access ([9f6715f](https://github.com/tutur3u/platform/commit/9f6715fb1c5a89598556cba33b16938b76995fc6))
+* restore apps launcher categories ([5c5b571](https://github.com/tutur3u/platform/commit/5c5b571ce920013bcfa5f327c4bb208ea9fbf23e))
+* **satellite:** widen apps launcher grid ([90e3106](https://github.com/tutur3u/platform/commit/90e31066830f535a7fdd0f7bc249e5bc8b273cfc))
+* **security:** limit auth recovery code attempts ([72d454c](https://github.com/tutur3u/platform/commit/72d454c507b0d4b7e69c7b38ad2099dbb83193b2))
+* **tasks:** route native personal task moves normally ([5bbba3c](https://github.com/tutur3u/platform/commit/5bbba3c3f193e722cc87cdfe2eb2734f61442cd0))
+* update launchable app catalog ([cb31207](https://github.com/tutur3u/platform/commit/cb312076aee227de9a8f99105d681911d14a63ac))
+* **web:** fail open without redis ([74bfcc7](https://github.com/tutur3u/platform/commit/74bfcc7ea5f188a56f49802c6a48bde0b109e02d))
+
+
+### Performance Improvements
+
+* **ci:** enable repository-wide remote caching ([6250f91](https://github.com/tutur3u/platform/commit/6250f91d745ef987a4fc86c797aedf41542f421b))
+
+## [0.14.0](https://github.com/tutur3u/platform/compare/utils-v0.13.0...utils-v0.14.0) (2026-07-11)
+
+
+### Features
+
+* **contacts:** migrate users attendance; add satellite-safe workspace-user link helper ([8f53453](https://github.com/tutur3u/platform/commit/8f534533793af8d25e7c2eca6e0147e459d78bbe))
+* **contacts:** migrate users topic-announcements module ([01e19ab](https://github.com/tutur3u/platform/commit/01e19ab60461ccd94a0374bed74ce6e4d5d38a3b))
+* **contacts:** scaffold contacts.tuturuuu.com satellite shell + monorepo registration ([7e335fc](https://github.com/tutur3u/platform/commit/7e335fc036c4a45ed189095ecd10a43ee002294b))
+* **pay:** scaffold apps/pay satellite (pay.tuturuuu.com, port 7826) ([3d6e45c](https://github.com/tutur3u/platform/commit/3d6e45cca6a315fe67213e438144b73103bae2f5))
+
+
+### Bug Fixes
+
+* **auth:** share account preference cookies ([8c1848a](https://github.com/tutur3u/platform/commit/8c1848a941c1b3f91337104c975e4bc0d8f68fc9))
+* restore apps launcher categories ([5c5b571](https://github.com/tutur3u/platform/commit/5c5b571ce920013bcfa5f327c4bb208ea9fbf23e))
+* **satellite:** widen apps launcher grid ([90e3106](https://github.com/tutur3u/platform/commit/90e31066830f535a7fdd0f7bc249e5bc8b273cfc))
+* update launchable app catalog ([cb31207](https://github.com/tutur3u/platform/commit/cb312076aee227de9a8f99105d681911d14a63ac))
+
+
+### Performance Improvements
+
+* **ci:** enable repository-wide remote caching ([6250f91](https://github.com/tutur3u/platform/commit/6250f91d745ef987a4fc86c797aedf41542f421b))
+
 ## [0.13.0](https://github.com/tutur3u/platform/compare/utils-v0.12.1...utils-v0.13.0) (2026-07-05)
 
 

package/biome.json

@@ -1,5 +1,5 @@
 {
   "root": false,
-  "$schema": "https://biomejs.dev/schemas/2.5.1/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.5.3/schema.json",
   "extends": "//"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tuturuuu/utils",
   "license": "MIT",
-  "version": "0.13.0",
+  "version": "0.15.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/tutur3u/platform",
@@ -20,11 +20,11 @@
     "@noble/ciphers": "^2.2.0",
     "@noble/hashes": "^2.2.0",
     "@tanstack/react-query": "^5.101.2",
-    "@tiptap/core": "3.27.1",
-    "@tiptap/react": "3.27.1",
+    "@tiptap/core": "3.27.3",
+    "@tiptap/react": "3.27.3",
     "@tuturuuu/google": "0.0.3",
     "@tuturuuu/icons": "0.0.6",
-    "@tuturuuu/internal-api": "0.14.1",
+    "@tuturuuu/internal-api": "0.18.0",
     "@tuturuuu/supabase": "0.4.0",
     "@upstash/ratelimit": "^2.0.8",
     "@upstash/redis": "^1.38.0",
@@ -35,7 +35,7 @@
     "effect": "^3.21.4",
     "moment": "^2.30.1",
     "next": "^16.3.0-preview.5",
-    "prosemirror-model": "^1.25.9",
+    "prosemirror-model": "^1.25.11",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "tailwind-merge": "^3.6.0",
@@ -45,15 +45,15 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@tuturuuu/types": "0.14.0",
+    "@tuturuuu/types": "0.17.0",
     "@tuturuuu/typescript-config": "0.1.1",
     "@types/diff": "^8.0.0",
-    "@types/node": "^26.0.1",
+    "@types/node": "^26.1.1",
     "@types/react": "^19.2.17",
     "@vitejs/plugin-react": "^6.0.3",
-    "typescript": "7.0.1-rc",
-    "vite": "^8.1.2",
-    "vitest": "^4.1.9"
+    "typescript": "7.0.2",
+    "vite": "^8.1.4",
+    "vitest": "^4.1.10"
   },
   "exports": {
     "./timezones": "./src/timezones.json",

package/src/__tests__/app-url.test.ts

@@ -231,6 +231,7 @@ describe('getLocalInternalAppUrl', () => {
     ['cms', 'https://cms.tuturuuu.localhost'],
     ['calendar', 'https://calendar.tuturuuu.localhost'],
     ['chat', 'https://chat.tuturuuu.localhost'],
+    ['docs', 'https://docs.tuturuuu.localhost'],
     ['drive', 'https://drive.tuturuuu.localhost'],
     ['qr', 'https://qr.tuturuuu.localhost'],
     ['tools', 'https://tools.tuturuuu.localhost'],
@@ -290,6 +291,8 @@ describe('Portless app origin registry', () => {
       'https://calendar.tuturuuu.localhost',
       'https://chat.tuturuuu.localhost',
       'https://cms.tuturuuu.localhost',
+      'https://contacts.tuturuuu.localhost',
+      'https://docs.tuturuuu.localhost',
       'https://drive.tuturuuu.localhost',
       'https://external.tuturuuu.localhost',
       'https://finance.tuturuuu.localhost',
@@ -302,6 +305,7 @@ describe('Portless app origin registry', () => {
       'https://meet.tuturuuu.localhost',
       'https://mind.tuturuuu.localhost',
       'https://nova.tuturuuu.localhost',
+      'https://pay.tuturuuu.localhost',
       'https://tuturuuu.localhost',
       'https://playground.tuturuuu.localhost',
       'https://qr.tuturuuu.localhost',

package/src/calendar-settings-resolver.ts

@@ -0,0 +1,200 @@
+/**
+ * Calendar Settings Resolver
+ *
+ * Implements priority system for calendar preferences:
+ * User settings > Workspace settings > Auto-detection
+ */
+
+type FirstDayOfWeek = 'auto' | 'sunday' | 'monday' | 'saturday';
+
+interface CalendarSettings {
+  timezone: string;
+  firstDayOfWeek: FirstDayOfWeek;
+  timeFormat: '12h' | '24h';
+}
+
+export interface CalendarUserSettings {
+  timezone?: string | null;
+  first_day_of_week?: string | null;
+  time_format?: string | null;
+}
+
+export interface CalendarWorkspaceSettings {
+  timezone?: string | null;
+  first_day_of_week?: string | null;
+}
+
+/**
+ * Detects the system timezone using Intl API
+ */
+export function detectSystemTimezone(): string {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().timeZone;
+  } catch {
+    // Fallback to UTC if detection fails
+    return 'UTC';
+  }
+}
+
+/**
+ * Detects the first day of week based on locale
+ * Vietnamese: Monday
+ * US/Canada: Sunday
+ * Middle East: Saturday
+ */
+export function detectLocaleFirstDay(locale?: string): FirstDayOfWeek {
+  const userLocale =
+    locale || (typeof navigator !== 'undefined' ? navigator.language : 'en-US');
+
+  // Vietnamese locale uses Monday as first day
+  if (userLocale.startsWith('vi')) {
+    return 'monday';
+  }
+
+  // US, Canada, and some other countries use Sunday
+  if (userLocale.startsWith('en-US') || userLocale.startsWith('en-CA')) {
+    return 'sunday';
+  }
+
+  // Middle Eastern countries typically use Saturday
+  if (userLocale.startsWith('ar') || userLocale.startsWith('he')) {
+    return 'saturday';
+  }
+
+  // Most European and other countries use Monday
+  return 'monday';
+}
+
+/**
+ * Detects the preferred time format based on locale
+ * Uses Intl.DateTimeFormat to determine if the locale uses 12h or 24h format
+ */
+export function detectLocaleTimeFormat(locale?: string): '12h' | '24h' {
+  const userLocale =
+    locale || (typeof navigator !== 'undefined' ? navigator.language : 'en-US');
+
+  try {
+    // Use Intl.DateTimeFormat to detect the locale's preferred format
+    const formatter = new Intl.DateTimeFormat(userLocale, { hour: 'numeric' });
+    const parts = formatter.formatToParts(new Date(2000, 0, 1, 13, 0));
+    const hourPart = parts.find((p) => p.type === 'hour');
+
+    // If hour is "1" instead of "13", it's 12-hour format
+    return hourPart?.value === '1' ? '12h' : '24h';
+  } catch {
+    // Fallback to 12h for English locales, 24h for others
+    return userLocale.startsWith('en') ? '12h' : '24h';
+  }
+}
+
+/**
+ * Resolves the effective time format based on user setting
+ */
+export function resolveTimeFormat(
+  user?: Pick<CalendarUserSettings, 'time_format'> | null,
+  locale?: string
+): '12h' | '24h' {
+  // User setting takes priority
+  if (user?.time_format && user.time_format !== 'auto') {
+    return user.time_format as '12h' | '24h';
+  }
+
+  // Auto-detection based on locale
+  return detectLocaleTimeFormat(locale);
+}
+
+/**
+ * Resolves the effective timezone based on priority system
+ */
+export function resolveTimezone(
+  user?: Pick<CalendarUserSettings, 'timezone'> | null,
+  workspace?: Pick<CalendarWorkspaceSettings, 'timezone'> | null
+): string {
+  // Priority 1: User setting
+  if (user?.timezone && user.timezone !== 'auto') {
+    return user.timezone;
+  }
+
+  // Priority 2: Workspace setting
+  if (workspace?.timezone && workspace.timezone !== 'auto') {
+    return workspace.timezone;
+  }
+
+  // Priority 3: Auto-detection
+  return detectSystemTimezone();
+}
+
+/**
+ * Resolves the effective first day of week based on priority system
+ */
+export function resolveFirstDayOfWeek(
+  user?: Pick<CalendarUserSettings, 'first_day_of_week'> | null,
+  workspace?: Pick<CalendarWorkspaceSettings, 'first_day_of_week'> | null,
+  locale?: string
+): FirstDayOfWeek {
+  // Priority 1: User setting
+  if (user?.first_day_of_week && user.first_day_of_week !== 'auto') {
+    return user.first_day_of_week as FirstDayOfWeek;
+  }
+
+  // Priority 2: Workspace setting
+  if (workspace?.first_day_of_week && workspace.first_day_of_week !== 'auto') {
+    return workspace.first_day_of_week as FirstDayOfWeek;
+  }
+
+  // Priority 3: Auto-detection based on locale
+  return detectLocaleFirstDay(locale);
+}
+
+/**
+ * Resolves all calendar settings at once
+ */
+export function resolveCalendarSettings(
+  user?: CalendarUserSettings | null,
+  workspace?: CalendarWorkspaceSettings | null,
+  locale?: string
+): CalendarSettings {
+  return {
+    timezone: resolveTimezone(user, workspace),
+    firstDayOfWeek: resolveFirstDayOfWeek(user, workspace, locale),
+    timeFormat: resolveTimeFormat(user, locale),
+  };
+}
+
+/**
+ * Converts first day of week string to number (for Date compatibility)
+ * 0 = Sunday, 1 = Monday, 6 = Saturday
+ */
+export function firstDayToNumber(day: FirstDayOfWeek, locale?: string): number {
+  if (day === 'auto') {
+    day = detectLocaleFirstDay(locale);
+  }
+
+  switch (day) {
+    case 'sunday':
+      return 0;
+    case 'monday':
+      return 1;
+    case 'saturday':
+      return 6;
+    default:
+      return 1; // Default to Monday
+  }
+}
+
+/**
+ * Converts number to first day of week string
+ * 0 = Sunday, 1 = Monday, 6 = Saturday
+ */
+export function numberToFirstDay(num: number): FirstDayOfWeek {
+  switch (num) {
+    case 0:
+      return 'sunday';
+    case 1:
+      return 'monday';
+    case 6:
+      return 'saturday';
+    default:
+      return 'monday'; // Default to Monday
+  }
+}

package/src/internal-domains.ts

@@ -16,6 +16,10 @@ export const PRODUCTION_INTERNAL_APP_DOMAINS = [
     name: 'cms',
     url: 'https://cms.tuturuuu.com',
   },
+  {
+    name: 'docs',
+    url: 'https://docs.tuturuuu.com',
+  },
   {
     name: 'calendar',
     url: 'https://calendar.tuturuuu.com',
@@ -96,6 +100,14 @@ export const PRODUCTION_INTERNAL_APP_DOMAINS = [
     name: 'teach',
     url: 'https://teach.tuturuuu.com',
   },
+  {
+    name: 'pay',
+    url: 'https://pay.tuturuuu.com',
+  },
+  {
+    name: 'contacts',
+    url: 'https://contacts.tuturuuu.com',
+  },
   {
     name: 'hive',
     url: 'https://hive.tuturuuu.com',
@@ -119,6 +131,10 @@ export const PORTLESS_INTERNAL_APP_DOMAINS = [
     name: 'cms',
     url: getTuturuuuPortlessAppOrigin('cms'),
   },
+  {
+    name: 'docs',
+    url: getTuturuuuPortlessAppOrigin('docs'),
+  },
   {
     name: 'calendar',
     url: getTuturuuuPortlessAppOrigin('calendar'),
@@ -191,6 +207,14 @@ export const PORTLESS_INTERNAL_APP_DOMAINS = [
     name: 'teach',
     url: getTuturuuuPortlessAppOrigin('teach'),
   },
+  {
+    name: 'pay',
+    url: getTuturuuuPortlessAppOrigin('pay'),
+  },
+  {
+    name: 'contacts',
+    url: getTuturuuuPortlessAppOrigin('contacts'),
+  },
   {
     name: 'hive',
     url: getTuturuuuPortlessAppOrigin('hive'),
@@ -286,6 +310,14 @@ export const LOCALHOST_INTERNAL_APP_DOMAINS = [
     name: 'teach',
     url: 'http://localhost:7813',
   },
+  {
+    name: 'pay',
+    url: 'http://localhost:7826',
+  },
+  {
+    name: 'contacts',
+    url: 'http://localhost:7827',
+  },
   {
     name: 'hive',
     url: 'http://localhost:7814',

package/src/launchable-apps.test.ts

@@ -3,6 +3,8 @@ import {
   getLaunchableApp,
   getLaunchableAppByTitle,
   getLaunchableAppOrigin,
+  LAUNCHABLE_APP_CATEGORIES,
+  LAUNCHABLE_APPS,
   type LaunchableWorkspace,
   resolveLaunchableAppPath,
   resolveLaunchableAppUrl,
@@ -27,6 +29,39 @@ describe('launchable apps', () => {
     expect(getLaunchableAppByTitle('apps gateway')?.slug).toBe('apps');
   });
 
+  it('keeps retired apps out of the catalog and pins category overrides', () => {
+    expect(LAUNCHABLE_APPS.map((app) => app.slug)).not.toContain('external');
+    expect(LAUNCHABLE_APPS.map((app) => app.slug)).not.toContain('playground');
+    expect(LAUNCHABLE_APP_CATEGORIES).not.toContain('core');
+    expect(LAUNCHABLE_APP_CATEGORIES).not.toContain('content');
+    expect(LAUNCHABLE_APP_CATEGORIES).not.toContain('developer');
+    expect(LAUNCHABLE_APP_CATEGORIES).toContain('miscellaneous');
+    expect(getLaunchableApp('external')).toBeNull();
+    expect(getLaunchableApp('playground')).toBeNull();
+    expect(getLaunchableApp('platform')?.category).toBe('productivity');
+    expect(getLaunchableApp('apps')?.category).toBe('miscellaneous');
+    expect(getLaunchableApp('cms')?.category).toBe('operations');
+    expect(getLaunchableApp('rewise')?.category).toBe('ai');
+    expect(getLaunchableApp('docs')?.category).toBe('miscellaneous');
+    expect(getLaunchableApp('tools')?.category).toBe('miscellaneous');
+    expect(getLaunchableApp('shortener')?.category).toBe('miscellaneous');
+    expect(
+      LAUNCHABLE_APPS.filter((app) => app.category === 'productivity').map(
+        (app) => app.slug
+      )[0]
+    ).toBe('platform');
+    expect(
+      LAUNCHABLE_APPS.filter((app) => app.category === 'operations').map(
+        (app) => app.slug
+      )
+    ).not.toContain('apps');
+    expect(
+      LAUNCHABLE_APPS.filter((app) => app.category === 'miscellaneous').map(
+        (app) => app.slug
+      )[0]
+    ).toBe('apps');
+  });
+
   it('resolves production, Portless, and local origins', () => {
     const app = getLaunchableApp('calendar');
 
@@ -46,6 +81,15 @@ describe('launchable apps', () => {
     expect(getLaunchableAppOrigin(meet!, { environment: 'production' })).toBe(
       'https://meet.tuturuuu.com'
     );
+
+    const docs = getLaunchableApp('docs');
+    expect(docs).not.toBeNull();
+    expect(getLaunchableAppOrigin(docs!, { environment: 'production' })).toBe(
+      'https://docs.tuturuuu.com'
+    );
+    expect(getLaunchableAppOrigin(docs!, { environment: 'portless' })).toBe(
+      'https://docs.tuturuuu.localhost'
+    );
   });
 
   it('detects Portless dev from the current origin', () => {

package/src/launchable-apps.ts

@@ -2,13 +2,11 @@ import { toWorkspaceSlug } from './constants';
 import { getTuturuuuPortlessAppOrigin } from './portless';
 
 export const LAUNCHABLE_APP_CATEGORIES = [
-  'core',
   'productivity',
-  'content',
   'operations',
   'learning',
-  'developer',
   'ai',
+  'miscellaneous',
 ] as const;
 
 export type LaunchableAppCategory = (typeof LAUNCHABLE_APP_CATEGORIES)[number];
@@ -53,7 +51,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Tuturuuu', 'Dashboard', 'Workspace'],
     appRoot: 'apps/web',
-    category: 'core',
+    category: 'productivity',
     defaultPath: '/',
     localhostOrigin: 'http://localhost:7803',
     packageName: '@tuturuuu/web',
@@ -63,18 +61,6 @@ export const LAUNCHABLE_APPS = [
     title: 'Platform',
     workspacePathResolver: workspaceRootPath,
   },
-  {
-    aliases: ['App Launcher', 'Gateway', 'Apps Gateway'],
-    appRoot: 'apps/apps',
-    category: 'core',
-    defaultPath: '/',
-    localhostOrigin: 'http://localhost:7818',
-    packageName: '@tuturuuu/apps',
-    portlessApp: 'apps',
-    productionUrl: 'https://apps.tuturuuu.com',
-    slug: 'apps',
-    title: 'Apps',
-  },
   {
     aliases: ['Schedule', 'Events'],
     appRoot: 'apps/calendar',
@@ -104,7 +90,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Content', 'CMS'],
     appRoot: 'apps/cms',
-    category: 'content',
+    category: 'operations',
     defaultPath: '/personal',
     localhostOrigin: 'http://localhost:7811',
     packageName: '@tuturuuu/cms',
@@ -128,15 +114,27 @@ export const LAUNCHABLE_APPS = [
     workspacePathResolver: workspaceRootPath,
   },
   {
-    aliases: ['External Projects', 'WebGL'],
-    appRoot: 'apps/external',
-    category: 'developer',
+    aliases: ['App Launcher', 'Gateway', 'Apps Gateway'],
+    appRoot: 'apps/apps',
+    category: 'miscellaneous',
     defaultPath: '/',
-    packageName: '@tuturuuu/external',
-    portlessApp: 'external',
-    productionUrl: 'https://external.tuturuuu.com',
-    slug: 'external',
-    title: 'External',
+    localhostOrigin: 'http://localhost:7818',
+    packageName: '@tuturuuu/apps',
+    portlessApp: 'apps',
+    productionUrl: 'https://apps.tuturuuu.com',
+    slug: 'apps',
+    title: 'Apps',
+  },
+  {
+    aliases: ['Documentation', 'Guides', 'Reference'],
+    appRoot: 'apps/docs',
+    category: 'miscellaneous',
+    defaultPath: '/',
+    packageName: 'apps/docs',
+    portlessApp: 'docs',
+    productionUrl: 'https://docs.tuturuuu.com',
+    slug: 'docs',
+    title: 'Docs',
   },
   {
     aliases: ['Money', 'Wallets', 'Invoices'],
@@ -251,21 +249,10 @@ export const LAUNCHABLE_APPS = [
     slug: 'nova',
     title: 'Nova',
   },
-  {
-    aliases: ['Labs', 'Sandbox'],
-    appRoot: 'apps/playground',
-    category: 'developer',
-    defaultPath: '/',
-    packageName: '@tuturuuu/playground',
-    portlessApp: 'playground',
-    productionUrl: 'https://playground.tuturuuu.com',
-    slug: 'playground',
-    title: 'Playground',
-  },
   {
     aliases: ['QR Code', 'Generator', 'Password', 'Random', 'UUID', 'Token'],
     appRoot: 'apps/tools',
-    category: 'developer',
+    category: 'miscellaneous',
     defaultPath: '/',
     localhostOrigin: 'http://localhost:7825',
     packageName: '@tuturuuu/tools',
@@ -277,7 +264,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Review', 'Flashcards'],
     appRoot: 'apps/rewise',
-    category: 'learning',
+    category: 'ai',
     defaultPath: '/',
     localhostOrigin: 'http://localhost:7804',
     packageName: '@tuturuuu/rewise',
@@ -289,7 +276,7 @@ export const LAUNCHABLE_APPS = [
   {
     aliases: ['Links', 'URL Shortener'],
     appRoot: 'apps/shortener',
-    category: 'developer',
+    category: 'miscellaneous',
     defaultPath: '/',
     packageName: '@tuturuuu/shortener',
     portlessApp: 'shortener',
@@ -323,6 +310,32 @@ export const LAUNCHABLE_APPS = [
     title: 'Teach',
     workspacePathResolver: workspaceRootPath,
   },
+  {
+    aliases: ['Billing', 'Subscriptions', 'Payments'],
+    appRoot: 'apps/pay',
+    category: 'operations',
+    defaultPath: '/personal',
+    localhostOrigin: 'http://localhost:7826',
+    packageName: '@tuturuuu/pay',
+    portlessApp: 'pay',
+    productionUrl: 'https://pay.tuturuuu.com',
+    slug: 'pay',
+    title: 'Pay',
+    workspacePathResolver: workspaceRootPath,
+  },
+  {
+    aliases: ['CRM', 'Users', 'Members', 'Customers', 'Leads'],
+    appRoot: 'apps/contacts',
+    category: 'operations',
+    defaultPath: '/personal',
+    localhostOrigin: 'http://localhost:7827',
+    packageName: '@tuturuuu/contacts',
+    portlessApp: 'contacts',
+    productionUrl: 'https://contacts.tuturuuu.com',
+    slug: 'contacts',
+    title: 'Contacts',
+    workspacePathResolver: workspaceRootPath,
+  },
   {
     aliases: ['Time Tracking', 'Timer'],
     appRoot: 'apps/track',