lfglabs-dev
diff --git a/‎.cursor/rules/architecture.mdc‎
Lines changed: 72 additions & 0 deletions b/‎.cursor/rules/architecture.mdc‎
Lines changed: 72 additions & 0 deletions
diff --git a/‎.cursor/rules/conventions.mdc‎
Lines changed: 67 additions & 0 deletions b/‎.cursor/rules/conventions.mdc‎
Lines changed: 67 additions & 0 deletions
@@ -0,0 +1,72 @@
+---
+alwaysApply: true
+---
+
+## Product Website Architecture
+
+- **Framework**: Next.js 15 (App Router) + React 19 + TypeScript 5.
+- **Runtime/PM**: Bun (see `bun.lock`). Prefer `bun run` for scripts.
+- **Purpose**: Product landing page with purchase links, documentation links, and blog for SEO.
+
+### Routing & Rendering
+
+- `app/page.tsx`: Main landing page with product information.
+- `app/blog/page.tsx`: Blog listing page.
+- `app/blog/[id]/page.tsx`: Individual blog post pages.
+- `app/blog/author/[id]/page.tsx`: Author pages.
+- `app/privacy/page.tsx` & `app/terms/page.tsx`: Legal pages.
+- `app/layout.tsx`: Root layout with Navigation and Footer components.
+- `app/chart/page.tsx`: Client-side chart rendering page (from GraphGPT fork).
+
+### Content Organization
+
+- `app/blog/posts/`: MDX blog posts with frontmatter.
+- `app/blog/authors/authors.json`: Author metadata (name, profile picture).
+- `public/`: Static assets (images, fonts, etc.).
+- Blog posts support frontmatter: `title`, `description`, `date`, `author`, `tags`, `image`, `featured`.
+
+### MDX Setup
+
+- Uses `next-mdx-remote` (RSC) for MDX compilation.
+- `mdx-components.tsx`: Custom MDX components (H1, H2, H3, P, Bold, links, etc.).
+- Custom components: `BlogEntry`, `ArticleImage`, `AiMarketShareChart`.
+- Posts are compiled server-side with `compileMDX` from `next-mdx-remote/rsc`.
+
+### Blog Features
+
+- `app/lib/blog.ts`: Blog utilities (`getAllPosts`, `getBlogPosts`, `getPostBySlug`).
+- Automatic reading time estimation.
+- Featured post support.
+- Author linking and profiles.
+- Tag support.
+
+### Configuration
+
+- `next.config.ts`: Basic config with asset prefixing via `baseUrl.ts`.
+- `tsconfig.json`: Strict TypeScript, modern ESM (`moduleResolution: Bundler`).
+- `tailwind.config.ts`: Tailwind CSS configuration.
+- `siteConfig.ts`: Site-wide configuration (name, URL, metadata).
+
+### Styling
+
+- Tailwind CSS for styling.
+- Radix UI components for accessible primitives.
+- `@tailwindcss/typography` for prose content.
+- Custom CSS variables for theming.
+
+### Components
+
+- `app/components/ui/`: UI components (Navbar, Footer, Hero, FAQs, etc.).
+- `app/components/blog/`: Blog-specific components (BlogPostCard, FeaturedPost, etc.).
+- Server components by default; add `"use client"` only when needed.
+
+### Build & Commands
+
+- Scripts: `bun run dev`, `bun run build`, `bun run start`.
+- Build generates static pages from MDX posts.
+
+### Notes
+
+- This is a product landing page, not a documentation site.
+- Blog is for SEO and content marketing.
+- Forked from GraphGPT but repurposed for Oraxen product.
@@ -0,0 +1,67 @@
+---
+alwaysApply: true
+---
+
+## Project Conventions
+
+- **Tech Stack**: Next.js 15 (App Router), React 19, TypeScript 5, Bun.
+- **Run commands**: use Bun
+  - `bun run dev`, `bun run build`, `bun run start`.
+- **Directory layout**:
+  - `app/`: Next App Router routes and components.
+  - `app/blog/posts/`: MDX blog posts.
+  - `app/components/`: React components (UI and blog-specific).
+  - `app/lib/`: Utility functions (blog helpers, scroll hooks, etc.).
+  - `public/`: Static assets (images, fonts, SVG icons).
+
+### TypeScript & React
+
+- **Strict mode**: keep `tsconfig` strict; no `any` unless absolutely necessary.
+- **ESM only**: use modern ESM imports; no CommonJS.
+- **Naming**: descriptive, self-explanatory names; avoid 1–2 char identifiers.
+- **Components**: server components by default; add `"use client"` only when needed.
+- **Control flow**: prefer early returns; avoid unnecessary try/catch.
+
+### MDX Authoring
+
+- Blog posts use standard Markdown in MDX files.
+- Frontmatter required: `title`, `description`, `date`, `author`, `tags`, `image`.
+- Optional: `featured`, `modifiedDate`, `readingTime`.
+- Custom components available: `BlogEntry`, `ArticleImage`, styled headings.
+- Images: Use Markdown `![Alt](...)` syntax.
+
+### Blog Post Structure
+
+```mdx
+---
+title: Post Title
+description: Post description
+date: 2024-01-01
+author: author-id
+tags: [tag1, tag2]
+image: /path/to/image.webp
+featured: true
+---
+
+Content here...
+```
+
+### Styling
+
+- Tailwind CSS for all styling.
+- Use Radix UI components for accessible primitives.
+- Custom design system components in `app/components/`.
+- Follow existing patterns for consistency.
+
+### Build & Validation
+
+- Builds must pass `bun run build`; TypeScript must compile cleanly.
+- Blog posts are compiled at build time via `next-mdx-remote/rsc`.
+- Always verify the site builds after edits.
+
+### SEO Focus
+
+- This is a product landing page with blog for SEO.
+- Include proper metadata in pages (title, description, OG tags).
+- Blog posts should be keyword-rich and well-structured.
+- Use semantic HTML and proper heading hierarchy.