{"id":14155609,"url":"https://github.com/zce/velite","last_synced_at":"2025-05-14T13:08:23.291Z","repository":{"id":203934729,"uuid":"710180330","full_name":"zce/velite","owner":"zce","description":"Turns Markdown / MDX, YAML, JSON, or others into app's data layer with Zod schema.","archived":false,"fork":false,"pushed_at":"2025-05-13T20:12:23.000Z","size":9912,"stargazers_count":593,"open_issues_count":25,"forks_count":31,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-05-13T21:29:23.922Z","etag":null,"topics":["content","contentlayer","datalayer","esbuild","headless-cms","markdown","mdx","typescript","velite","zod"],"latest_commit_sha":null,"homepage":"http://velite.js.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zce.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"license","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"zce"}},"created_at":"2023-10-26T07:21:29.000Z","updated_at":"2025-05-06T09:52:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"6dbb3941-92ed-4395-a1f1-e3680c64878b","html_url":"https://github.com/zce/velite","commit_stats":{"total_commits":541,"total_committers":13,"mean_commits":41.61538461538461,"dds":"0.14048059149722736","last_synced_commit":"90b61e510728b0cad22ae7b48244a66405182d9b"},"previous_names":["zce/creative","zce/velite"],"tags_count":76,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zce%2Fvelite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zce%2Fvelite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zce%2Fvelite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zce%2Fvelite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zce","download_url":"https://codeload.github.com/zce/velite/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149968,"owners_count":22022852,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["content","contentlayer","datalayer","esbuild","headless-cms","markdown","mdx","typescript","velite","zod"],"created_at":"2024-08-17T08:04:25.211Z","updated_at":"2025-05-14T13:08:18.276Z","avatar_url":"https://github.com/zce.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://velite.js.org\"\u003e\n    \u003cpicture\u003e\n      \u003csource srcset=\"https://velite.js.org/assets/logo-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n      \u003cimg src=\"https://velite.js.org/assets/logo.svg\" width=\"300 alt=\"Velite\" title=\"Velite\"\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003cp\u003eTurns Markdown / MDX, YAML, JSON, or other files into app's data layer with type-safe schema.\u003c/p\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://github.com/zce/velite/actions\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/zce/velite/main.yml\" alt=\"Build Status\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/zce/velite/blob/master/license\"\u003e\u003cimg src=\"https://img.shields.io/github/license/zce/velite\" alt=\"License\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://npm.im/velite\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/velite\" alt=\"NPM Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://npm.im/velite\"\u003e\u003cimg src=\"https://img.shields.io/node/v/velite\" alt=\"Node Version\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://standardjs.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/code_style-standard-brightgreen\" alt=\"Code Style\"\u003e\u003c/a\u003e\n    \u003cbr\u003e\n    \u003ca href=\"https://npm.im/velite\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/velite\" alt=\"NPM Downloads\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://packagephobia.com/result?p=velite\"\u003e\u003cimg src=\"https://packagephobia.com/badge?p=velite\" alt=\"Install Size\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/zce/velite\"\u003e\u003cimg src=\"https://img.shields.io/librariesio/release/npm/velite\" alt=\"Dependencies Status\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## What is Velite?\n\nVelite is a tool for building type-safe data layer, turns Markdown / MDX, YAML, JSON, or other files into app's data layer with Zod schema.\n\n\u003cpicture\u003e\n  \u003csource srcset=\"https://velite.js.org/assets/flow-dark.svg\" media=\"(prefers-color-scheme: dark)\"\u003e\n  \u003cimg src=\"https://velite.js.org/assets/flow.svg\" alt=\"Velite Workflow\" title=\"Velite Workflow\"\u003e\n\u003c/picture\u003e\n\n### Naming Origin\n\n\"Velite\" comes from the English word \"elite\".\n\n\u003e \"Velite\" itself is the code name for Napoleon's elite army.\n\n## Key Features\n\n- **Easy to use**: Move your contents into `content` folder, define collections schema, run `velite`, then use the output data in your application.\n- **Type-safe**: Contents schema validation by [Zod](https://zod.dev), and generate type inference for TypeScript.\n- **Framework Agnostic**: JSON \u0026 Entry \u0026 DTS output, out of the box support for any JavaScript framework or library.\n- **Light-weight**: Choose more native APIs instead of bloated NPM modules, less runtime dependencies, so it is fast and efficiently.\n- **Still powerful**: Built-in Markdown / MDX, YAML, JSON support, relative files \u0026 images processing, schema validation, etc.\n- **Configurable**: Both input and output directories can be customized, and support for custom loaders, hooks, etc.\n- **Extensible**: Support any file types by custom loaders, Custom field validation and transform by custom schema, and any output formats by hooks.\n\nCheck out our detailed [Why Velite](https://velite.js.org/guide/introduction#why-velite) to learn more about what makes Velite special. ✨\n\n## Try Velite Online\n\nYou can try Velite directly in your browser on StackBlitz:\n\n- https://stackblitz.com/edit/velite-basic\n- https://stackblitz.com/edit/velite-nextjs\n\n\u003e [!NOTE]\n\u003e You may need a real-world project to start Velite quickly.\n\u003e I have forked the [shadcn-ui/taxonomy](https://tx.shadcn.com) project as an example, you can try it out.\n\u003e https://github.com/zce/taxonomy\n\n## Who's using Velite?\n\n- [Ark UI](https://github.com/chakra-ui/ark)\n- [Chakra UI](https://github.com/chakra-ui/chakra-ui)\n- [Park UI](https://github.com/cschroeter/park-ui)\n- [etc.](https://github.com/zce/velite/network/dependents)\n\n## Roadmap\n\nThe following are the features I want to achieve or are under development:\n\n- [ ] More framework or build tool integration examples.\n- [ ] More built-in schemas\n- [ ] Unit \u0026 E2E tests?\n- [ ] Scoffolding tool\n- [ ] Incremental build\n- [ ] Turborepo?\n- [ ] Next.js plugin package? It's currently a [snippet](https://velite.js.org/guide/with-nextjs#start-velite-with-next-js-plugin).\n\nSee the [open issues](https://github.com/zce/velite/issues) for a list of proposed features (and known issues).\n\n## Contributing\n\n1. **Fork** it on GitHub!\n2. **Clone** the fork to your own machine.\n3. **Checkout** your feature branch: `git checkout -b my-awesome-feature`\n4. **Commit** your changes to your own branch: `git commit -am 'Add some feature'`\n5. **Push** your work back up to your fork: `git push -u origin my-awesome-feature`\n6. Submit a **Pull Request** so that we can review your changes.\n\n\u003e [!NOTE]\n\u003e Be sure to merge the latest from \"upstream\" before making a pull request!\n\n## License\n\n[MIT](license) \u0026copy; [zce](https://zce.me)\n","funding_links":["https://github.com/sponsors/zce"],"categories":["TypeScript","typescript"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzce%2Fvelite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzce%2Fvelite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzce%2Fvelite/lists"}