Merge branch 'main' into perplexity-flutter

Author: kesku

.github/workflows/pr-validation.yml

@@ -0,0 +1,48 @@
+name: MDX Validation
+
+on:
+  pull_request:
+    branches: [ main ]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/**'
+
+jobs:
+  mdx-validation:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+        
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+          
+      - name: MDX validation dependencies
+        run: npm install --save-dev @mdx-js/mdx @mdx-js/loader glob
+        
+      - name: Validate MDX files
+        run: node scripts/validate-mdx.js
+          
+      - name: Check for broken links
+        run: |
+          # Simple check for common broken link patterns
+          echo "Checking for potential broken links..."
+          if grep -r "http://localhost\|http://127.0.0.1" docs/; then
+            echo "❌ Found localhost links that should be removed"
+            exit 1
+          fi
+          echo "✅ No obvious broken links found"
+          
+      - name: Validate frontmatter
+        run: |
+          # Check that all MDX files have required frontmatter
+          find docs -name "*.mdx" -type f | while read file; do
+            if ! head -n 10 "$file" | grep -q "^---$"; then
+              echo "❌ $file - Missing frontmatter (no --- markers)"
+              exit 1
+            fi
+            echo "✅ $file - Has frontmatter"
+          done 

docs/showcase/briefo.mdx

@@ -0,0 +1,64 @@
+---
+title: Briefo | Perplexity Powered News & Finance Social App
+description: AI curated newsfeed, social discussion, and deep research reports built on the Sonar API
+sidebar_position: 1
+keywords: [Briefo, finance, news, social media, React Native, Supabase]
+---
+
+# Briefo | Perplexity Powered News & Finance Social App
+
+**Briefo** delivers a personalized, AI generated newsfeed and company deep dives. Readers can follow breaking stories, request on demand financial analyses, and discuss insights with friends, all in one mobile experience powered by Perplexity’s Sonar API.
+
+## Features
+
+* Personalized newsfeed across 17 categories with AI summaries and source links  
+* Private and public threads for article discussion and sharing  
+* Watch list with real time market snapshots and optional AI analyses  
+* Deep research reports generated on 12 selectable criteria such as management, competitors, and valuation  
+* General purpose chat assistant that remembers each user’s preferred topics  
+
+## Prerequisites
+
+* Node 18 LTS or newer  
+* npm, Yarn, or pnpm  
+* Expo CLI (`npm i -g expo-cli`)  
+* Supabase CLI 1.0 or newer for local emulation and Edge Function deploys  
+
+## Installation
+
+git clone https://github.com/adamblackman/briefo-public.git
+cd briefo-public
+npm install
+### Environment variables
+
+# .env              (project root)
+MY_SUPABASE_URL=https://<project>.supabase.co
+MY_SUPABASE_SERVICE_ROLE_KEY=...
+PERPLEXITY_API_KEY=...
+LINKPREVIEW_API_KEY=...
+ALPACA_API_KEY=...
+ALPACA_SECRET_KEY=...
+
+# .env.local        (inside supabase/)
+# duplicate or override any secrets needed by Edge Functions
+
+## Usage
+Run the Expo development server:
+
+npx expo start
+
+Deploy Edge Functions when you are ready:
+
+supabase functions deploy perplexity-news perplexity-chat perplexity-research portfolio-tab-data
+
+## Code Explanation
+
+* Frontend: React Native with Expo Router (TypeScript) targeting iOS, Android, and Web
+* Backend: Supabase (PostgreSQL, Row Level Security, Realtime) for data and authentication
+* Edge Functions: TypeScript on Deno calling Perplexity, Alpaca, Alpha Vantage, and LinkPreview APIs
+* Hooks: Reusable React Query style data hooks live in lib/ and hooks/
+* Testing and Linting: ESLint, Prettier, and Expo Lint maintain code quality
+
+## Links
+https://github.com/adamblackman/briefo-public
+https://www.briefo.fun/