add preact store, standardize framework font-colors (#553)

* add preact store, standardize framework font-colors

* prettier

Author: KevinVandy

AGENTS.md

@@ -7,6 +7,7 @@
 ### Avoid Type Casting
 
 We **never ever** cast types unless it's absolutely necessary. This includes:
+
 - Manual generic type parameters (e.g., `<Type>`)
 - Type assertions using `as`
 - Type assertions using `satisfies`
@@ -15,23 +16,26 @@ We **never ever** cast types unless it's absolutely necessary. This includes:
 ### Prefer Type Inference
 
 Always infer types and go up the logical chain as far as we can control to determine types. The preferred approach is:
+
 1. **Schema validation** - Use schema definitions (e.g., Convex schema, Zod, etc.) as the source of truth
 2. **Type inference from concrete sources** - Let TypeScript infer types from function return types, API responses, etc.
 3. **Go up the chain** - Trace types back to their source rather than casting at the point of use
 
 ### Example
 
 ❌ **Bad:**
+
 ```typescript
-const result = api.getData() as MyType;
-const value = getValue<MyType>();
+const result = api.getData() as MyType
+const value = getValue<MyType>()
 ```
 
 ✅ **Good:**
+
 ```typescript
 // Infer from schema or API definition
-const result = api.getData(); // Type inferred from api.getData return type
-const value = getValue(); // Type inferred from function implementation
+const result = api.getData() // Type inferred from api.getData return type
+const value = getValue() // Type inferred from function implementation
 ```
 
 If types need to be fixed, fix them at the source (schema, API definition, function signature) rather than casting at the point of use.
@@ -45,6 +49,7 @@ If types need to be fixed, fix them at the source (schema, API definition, funct
 Only include the properties from `search` (or other sources) that are actually used in the loader function. This ensures proper cache invalidation and prevents unnecessary re-runs when unrelated search params change.
 
 ❌ **Bad:**
+
 ```typescript
 loaderDeps: ({ search }) => search, // Includes everything, even unused params
 loader: async ({ deps }) => {
@@ -54,6 +59,7 @@ loader: async ({ deps }) => {
 ```
 
 ✅ **Good:**
+
 ```typescript
 loaderDeps: ({ search }) => ({
   page: search.page,
@@ -66,4 +72,3 @@ loader: async ({ deps }) => {
 ```
 
 This ensures the loader only re-runs when the specific dependencies change, not when unrelated search params (like `expanded`, `viewMode`, etc.) change.
-

agents/tasks/feed-admin-fixes.md

@@ -3,36 +3,43 @@
 ## Issues Found and Fixed
 
 ### 1. Route Navigation - ✅ FIXED
+
 **File**: `src/routes/admin/feed.tsx`
 **Issue**: Using `/admin/feed/new` which doesn't exist as a route
 **Fix**: Changed to `/admin/feed/$id` with `params={{ id: 'new' }}`
 
 ### 2. Navigation Search Params - ✅ FIXED
+
 **File**: `src/routes/admin/feed.tsx`
 **Issue**: Direct object assignment to search params
 **Fix**: Updated to use function form: `search: (s) => ({ ...s, ...updates })`
 
 ### 3. Window Confirm - ✅ FIXED
+
 **File**: `src/routes/admin/feed.tsx`
 **Issue**: Using `confirm()` without `window.` prefix
 **Fix**: Changed to `window.confirm()`
 
 ### 4. Type Error in FeedEntryEditor - ✅ FIXED
+
 **File**: `src/routes/admin/feed.$id.tsx`
 **Issue**: `entryQuery` could be `undefined` but type expects `FeedEntry | null`
 **Fix**: Added null coalescing: `entryQuery ?? null`
 
 ### 5. Unused Imports - ✅ FIXED
+
 **Files**: Multiple admin files
 **Issue**: Unused imports causing warnings
 **Fix**: Removed unused imports (`useState`, `useEffect`, `validateManualEntry`)
 
 ### 6. Library Filter Property - ✅ FIXED
+
 **File**: `src/components/admin/FeedEntryEditor.tsx`
 **Issue**: Accessing `lib.visible` property that doesn't exist
 **Fix**: Removed filter for non-existent property
 
 ### 7. Actions Export - ✅ FIXED
+
 **File**: `src/components/admin/FeedSyncStatus.tsx`
 **Issue**: `api.feed.actions` doesn't exist in generated API
 **Fix**: Removed `syncAllSources` button and updated to use `useAction` hook. GitHub sync works via `api.feed.github.syncGitHubReleases`.
@@ -41,11 +48,13 @@
 ## Remaining Issues
 
 ### 1. Actions Not Exported
+
 **File**: `convex/feed/actions.ts`
 **Issue**: Actions file exists but `api.feed.actions` is not available
 **Status**: Need to verify Convex file structure. Actions may need to be in root `convex/` directory or registered differently.
 
 ### 2. Route Search Params Type Errors - ✅ FIXED
+
 **File**: `src/routes/admin/feed.tsx`
 **Issue**: TypeScript errors with search param updates
 **Fix**: Changed from `useNavigate()` to `Route.useNavigate()` and updated search param updates to use object spread instead of function form
@@ -69,4 +78,3 @@
    - Delete post
    - Toggle visibility
    - Toggle featured
-

agents/tasks/feed-feature-plan.plan.md

@@ -506,4 +506,3 @@ src/
 3. Backfill recent blog posts
 4. Announce feature to users
 5. Monitor and iterate based on feedback
-

agents/tasks/feed-validation-fixes.md

@@ -3,34 +3,41 @@
 ## Issues Found
 
 ### 1. Schema Index Issue - ✅ FIXED
+
 **File**: `convex/schema.ts`
 **Issue**: The `by_library` index on `libraryIds` array field won't work. Convex doesn't support direct array indexing.
 **Fix**: ✅ Removed the invalid index and added a comment explaining why.
 
 ### 2. Hydration Warning - ✅ FIXED
+
 **File**: `src/routes/_libraries/feed.tsx`
 **Issue**: React hydration mismatch warning due to localStorage access during SSR.
 **Fix**: ✅ Updated to use `useMounted` hook to ensure localStorage access only happens client-side.
 
 ### 3. Missing sourceId Field
+
 **File**: `convex/schema.ts`
 **Issue**: Schema defines `sourceId` in the plan but it's missing from the actual schema.
 **Status**: Check if this is needed - if entries need to track original source IDs (e.g., GitHub release ID), add it.
 
 ### 4. FeedList Loading State
+
 **File**: `src/components/FeedList.tsx`
 **Issue**: Need to verify loading states are properly displayed.
 **Status**: Check implementation - should show loading spinner while query is pending.
 
 ### 5. Admin Authentication
+
 **File**: `src/routes/admin/feed.tsx`
 **Status**: ✅ Working correctly - shows auth prompt when not logged in.
 
 ### 6. Filter URL Encoding
+
 **File**: `src/routes/_libraries/feed.tsx`
 **Status**: ✅ Working correctly - filters update URL params properly.
 
 ### 7. Console Errors
+
 **Issue**: Some unrelated 404 errors for auth endpoints (`/api/auth/display-name/to-string`, `/api/auth/display-name/value-of`)
 **Status**: These appear to be unrelated to feed feature - likely existing auth system issues.
 
@@ -60,4 +67,3 @@
 3. Test admin interface with authenticated user
 4. Test GitHub sync when webhook is configured
 5. Test blog sync functionality
-

convex/feed/crypto.ts

@@ -17,7 +17,9 @@ export const verifyGitHubSignature = action({
     const crypto = require('crypto')
     const hmac = crypto.createHmac('sha256', args.secret)
     const digest = 'sha256=' + hmac.update(args.payload).digest('hex')
-    return crypto.timingSafeEqual(Buffer.from(args.signature), Buffer.from(digest))
+    return crypto.timingSafeEqual(
+      Buffer.from(args.signature),
+      Buffer.from(digest)
+    )
   },
 })
-

convex/feed/queries.ts

@@ -467,7 +467,9 @@ export const getFeedFacetCounts = query({
 
     // Count featured
     const featuredEntries = applyFiltersExcept(entries, 'featured')
-    const featuredCount = featuredEntries.filter((entry) => entry.featured).length
+    const featuredCount = featuredEntries.filter(
+      (entry) => entry.featured
+    ).length
 
     return {
       sources: sourceCounts,

convex/feed/timestamps.ts

@@ -1,14 +1,14 @@
 /**
  * Timestamp management for feed entries
- * 
+ *
  * Timestamp semantics:
  * - publishedAt: When the content was originally published (from source or manually set)
  *   This is the primary timestamp for sorting and display - represents when content was actually published
  * - createdAt: When the entry was created in our feed system (when we added it to the database)
  * - updatedAt: When the entry was last modified in our system
  * - lastSyncedAt: When we last synced from external source (only for auto-synced entries)
  * - _createdAt: Convex internal timestamp (automatic, don't use in business logic)
- * 
+ *
  * Rules:
  * - Always sort by publishedAt (when content was published, not when we added it)
  * - createdAt should never be used for display/sorting
@@ -72,4 +72,3 @@ export function validatePublishedAt(publishedAt: number): {
 
   return { valid: true }
 }
-

convex/schema.ts

@@ -6,7 +6,12 @@ import { feedCategoryValidator } from './feed/schema'
 
 // Zod schema for valid capabilities
 // Valid capabilities list (exported for use throughout the app)
-export const VALID_CAPABILITIES = ['admin', 'disableAds', 'builder', 'feed'] as const
+export const VALID_CAPABILITIES = [
+  'admin',
+  'disableAds',
+  'builder',
+  'feed',
+] as const
 export const CapabilitySchema = z.enum(VALID_CAPABILITIES)
 export type Capability = z.infer<typeof CapabilitySchema>
 

src/components/DocsLayout.tsx

@@ -5,7 +5,7 @@ import { Link, useMatches, useParams } from '@tanstack/react-router'
 import { useLocalStorage } from '~/utils/useLocalStorage'
 import { last } from '~/utils/utils'
 import type { ConfigSchema, MenuItem } from '~/utils/config'
-import { Framework } from '~/libraries'
+import { Framework, frameworkOptions } from '~/libraries'
 import { DocsCalloutQueryGG } from '~/components/DocsCalloutQueryGG'
 import { twMerge } from 'tailwind-merge'
 import { partners, PartnerImage } from '~/utils/partners'
@@ -248,23 +248,9 @@ export function DocsLayout({
                               className={`text-xs ${
                                 props.isActive ? 'opacity-100' : 'opacity-40'
                               } group-hover:opacity-100 font-bold transition-opacity ${
-                                child.badge === 'react'
-                                  ? 'text-sky-500'
-                                  : child.badge === 'solid'
-                                  ? 'text-blue-500'
-                                  : child.badge === 'svelte'
-                                  ? 'text-orange-500'
-                                  : child.badge === 'vue'
-                                  ? 'text-green-500'
-                                  : child.badge === 'angular'
-                                  ? 'text-fuchsia-500'
-                                  : child.badge === 'qwik'
-                                  ? 'text-indigo-500'
-                                  : child.badge === 'lit'
-                                  ? 'text-emerald-500'
-                                  : child.badge === 'vanilla'
-                                  ? 'text-yellow-500'
-                                  : 'text-gray-500'
+                                frameworkOptions.find(
+                                  (f) => f.value === child.badge
+                                )?.fontColor ?? 'text-gray-500'
                               }`}
                             >
                               {child.badge}

src/components/FeedEntry.tsx

@@ -253,7 +253,7 @@ export function FeedEntry({
             className="text-xs font-semibold text-gray-900 dark:text-gray-100 truncate hover:text-blue-600 dark:hover:text-blue-400 transition-colors"
           >
             {entry.title}
-            </Link>
+          </Link>
         </TableCell>
 
         {/* Excerpt */}