add-project

name	add-project
description	Add a new project to the awesome list from a GitHub repository URL
argument-hint	<github-repo-url>

Add a new project entry to data/LIST.json from the given GitHub repository URL: $ARGUMENTS

Follow these steps:

1. Fetch project info: Use WebFetch to visit the GitHub repository URL and extract:

   • Project description (write concise en-US and zh-CN descriptions)
   • Author/owner info: Determine whether the repository owner (the first part of owner/repo in the URL) is a GitHub organization or a personal account. If it is an organization, use the organization name and URL as the author. Only use an individual's name if the owner is a personal account.
   • License (if any)
   • Any website links (homepage, demo, etc.)

2. Read current list: Read data/LIST.json to determine the next available id (last entry's id + 1) and understand the existing format.

3. Read field definitions: Read website/shared/fields.ts to check valid categories (CATEGORIES) and website providers (WEBSITE_PROVIDERS).

4. Choose category and tags: Select the most appropriate category and tags based on the project's purpose. Refer to existing entries for tag conventions.

5. Add entry: Append the new project entry to data/LIST.json before the closing ]. Follow the ProjectProps & ProjectMeta interface from website/shared/project.ts:

   • name: Use author/repo format
   • description: Object with en-US and zh-CN keys
   • repository: The GitHub URL
   • website: Array of { provider, url } objects (only if applicable)
   • author: Object with name and url. Use the repository owner (organization or user) from the GitHub URL, not an individual contributor mentioned in the README
   • category: One of the valid categories
   • tags: Array of relevant tags
   • id: Next sequential id
   • addedAt: Today's date in YYYY-MM-DD format
   • openSource: true if repository field is present
   • license: Include only if a license is detected

6. Run validation and generation: Execute the following commands sequentially in the website directory using bun:

   bun run check:list && bun run format:list && bun run generate:list
   

7. Report result: Show the added entry name, id, category, and whether all checks passed.