SuperAPI AI 工具集

freecodecamp-curriculum

通用与其它

查看项目

更新于 10-16 07:27

技能介绍

freeCodeCamp 是一个免费、开源的学习平台,包含大量交互式编程挑战、认证与全栈课程。该资料是围绕其开源代码库与课程平台的综合贡献指南。

用途:帮助开发者参与 freeCodeCamp 代码库与课程内容的开发与贡献。

架构概览:api/ 为 Fastify API 服务(TypeScript);client/ 为 Gatsby/React 前端;curriculum/ 存放全部挑战与认证(YAML/Markdown),按 superblock 与 block 目录组织;tools/ 含课程辅助脚本与共享 UI 组件;e2e/ 为 Playwright 端到端测试。

本地环境:需 Node.js 20+、pnpm 9+、MongoDB 与用于 OAuth 的 GitHub 账号。步骤为:git clone https://github.com/<YOUR_USERNAME>/freeCodeCamp.git,cd freeCodeCamp,pnpm install,cp sample.env .env 后配置 MONGOHQ_URL、GITHUB_ID、GITHUB_SECRET、JWT_SECRET、SESSION_SECRET 等;pnpm run seed 初始化数据库;pnpm run develop 启动全部服务,或用 develop:api(默认 :3000)与 develop:client(Gatsby :8000)单独启动。

课程结构:挑战以 YAML 前置元数据加 Markdown 正文存储,含 id、title、challengeType、forumTopicId、dashedName 等字段,正文用 --description--、--instructions--、--hints--、--seed--、--solutions-- 分段。challengeType 涵盖 HTML、JavaScript、JSX、Vanilla JS、Python、Project、Video 等。可用 pnpm run create-challenge 交互式创建,或用 node 结合 bson 的 ObjectId 生成 24 位十六进制唯一 ID;每个 block 还需 _meta.json。

主要能力:可编写与校验挑战测试(assert.match、assert.strictEqual 等),开发 Fastify 路由与 Mongoose 数据模型,构建 Gatsby/React 页面与 Redux 选择器,配置 i18n 翻译,并运行 Jest 单元测试、课程测试与 Playwright E2E 测试。常用命令包括 pnpm test、pnpm run test:curriculum、pnpm run lint:curriculum、pnpm run test:e2e、pnpm run build 等。

贡献流程:创建功能分支、修改并测试、运行 lint、使用约定式提交(如 fix:、feat:、chore:)后推送并发起 PR。资源含贡献指南、论坛与 Discord(具体地址见官方渠道)。

限制:资料未提供具体的收费、价格、平台兼容或效果承诺信息,相关事实暂未提供。命令、URL 与代码应保持原样,实际执行需结合官方最新文档。