Skip to content

Latest commit

 

History

History
38 lines (28 loc) · 1.73 KB

AGENTS.md

File metadata and controls

38 lines (28 loc) · 1.73 KB

LaunchPad.dev - AI Agent Core Instructions

1. Project Overview

  • Project Name: LaunchPad.dev (GitHub Repo: launchpad)

This project is a centralized documentation and cheat-sheet platform for JavaScript/TypeScript package managers (npm, pnpm, yarn, bun, deno). It provides fast, searchable, and OS-specific (Windows/Linux/macOS) commands for project initialization (create commands) and package management.

2. Tech Stack

  • Framework: Astro.js (Static Site Generation - SSG)
  • UI Components: React 19 + TypeScript
  • Styling: Tailwind CSS v4
  • Package Manager: pnpm
  • Data Management: Astro Content Collections (MDX files)
  • Search: Client-side fuzzy search (e.g., Fuse.js)

3. Coding Standards & Rules

  • Package Manager: ALWAYS use pnpm for installing dependencies or running scripts. NEVER use npm or yarn.
  • TypeScript: Strict mode is enabled. Always define explicit interfaces/types for props and data structures. Avoid any.
  • Component Architecture: Use Astro components (.astro) for static layouts, pages, and SEO-heavy parts. Use React components (.tsx) ONLY for highly interactive islands (e.g., Search Bar, OS Tabs, Copy to Clipboard buttons).
  • Styling: Use standard Tailwind CSS utility classes.
  • Naming Conventions: - React components: PascalCase (e.g., CommandCard.tsx)
    • Utilities/Hooks: camelCase (e.g., useSearch.ts)
    • MDX Data Files: kebab-case (e.g., next-js.mdx)

4. Data Structure (MDX Content Collections)

Tools and commands are stored as .mdx files in src/content/tools/. Example Frontmatter schema:

title: "Next.js"
description: "The React Framework for the Web"
category: "Framework"
docsUrl: "[https://nextjs.org/docs](https://nextjs.org/docs)"