{"id":47258995,"url":"https://github.com/vanduo-oss/framework","last_synced_at":"2026-05-23T12:03:17.671Z","repository":{"id":335367465,"uuid":"1127658109","full_name":"vanduo-oss/framework","owner":"vanduo-oss","description":"A lightweight, pure HTML/CSS/JS framework for designing beautiful websites. ","archived":false,"fork":false,"pushed_at":"2026-05-20T14:59:05.000Z","size":23087,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-05-20T19:48:51.734Z","etag":null,"topics":["css","foss","framework","html","html5","javascript","javascript-framework","js","open-color","phosphor-icons","vanduo-framework","web","web-framework","webframework"],"latest_commit_sha":null,"homepage":"https://vanduo.dev/","language":"CSS","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/vanduo-oss.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-04T10:45:26.000Z","updated_at":"2026-05-20T15:00:14.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vanduo-oss/framework","commit_stats":null,"previous_names":["nostromo-618/vanduo-framework","vanduo-oss/framework"],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/vanduo-oss/framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanduo-oss%2Fframework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanduo-oss%2Fframework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanduo-oss%2Fframework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanduo-oss%2Fframework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vanduo-oss","download_url":"https://codeload.github.com/vanduo-oss/framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vanduo-oss%2Fframework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33394674,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["css","foss","framework","html","html5","javascript","javascript-framework","js","open-color","phosphor-icons","vanduo-framework","web","web-framework","webframework"],"created_at":"2026-03-14T22:24:02.372Z","updated_at":"2026-05-23T12:03:17.665Z","avatar_url":"https://github.com/vanduo-oss.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vanduo Framework v1.4.1\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"vanduo-banner.svg\" alt=\"Vanduo Framework Banner\" width=\"100%\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@vanduo-oss/framework\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/@vanduo-oss/framework?style=flat-square\u0026color=3b82f6\" alt=\"NPM Version\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/vanduo-oss/framework/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/vanduo-oss/framework/ci.yml?branch=main\u0026style=flat-square\u0026color=10b981\" alt=\"Build Status\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/vanduo-oss/framework/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/github/license/vanduo-oss/framework?style=flat-square\u0026color=64748b\" alt=\"License\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nVanduo is a zero-dependency UI framework built with HTML, CSS, and vanilla JavaScript. It ships a full component bundle, scoped runtime initialization, and a strict canonical `--vd-*` token API.\n\n[Browse Docs](https://vanduo.dev/#docs)\n\n## Highlights\n\n- Zero runtime dependencies\n- 47+ components across layout, navigation, overlays, search, and effects\n- Scoped runtime APIs for dynamic DOM work\n- Strict design token API under `--vd-*`\n- Built-in dark, light, and system theming\n- Theme customizer with color, font, and radius controls\n- Playwright-based browser coverage across Chromium, Firefox, and WebKit\n\n## Quick Start\n\n### CDN\n\n```html\n\u003clink rel=\"stylesheet\" href=\"https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.4.1/dist/vanduo.min.css\"\u003e\n\u003cscript src=\"https://cdn.jsdelivr.net/gh/vanduo-oss/framework@v1.4.1/dist/vanduo.min.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n  Vanduo.init();\n\u003c/script\u003e\n```\n\n### Local Dist Files\n\n```html\n\u003clink rel=\"stylesheet\" href=\"dist/vanduo.min.css\"\u003e\n\u003cscript src=\"dist/vanduo.min.js\"\u003e\u003c/script\u003e\n\u003cscript\u003e\n  Vanduo.init();\n\u003c/script\u003e\n```\n\n### Package Install\n\n```bash\npnpm add @vanduo-oss/framework\n```\n\n```js\nimport '@vanduo-oss/framework/css';\nimport { Vanduo } from '@vanduo-oss/framework';\n\nVanduo.init();\n```\n\n## Runtime API\n\n```js\nVanduo.init(root);\nVanduo.initComponents(root);\nVanduo.reinit('lazyLoad', root);\nVanduo.destroy(root);\nVanduo.destroyAll();\nVanduo.getComponent('docSearch');\n```\n\n- Omit `root` to target the full document.\n- Pass an `Element` to initialize or destroy only a subtree.\n- Canonical component registry names use `lowerCamelCase`.\n- `LazyLoad` remains available as a compatibility alias for `lazyLoad` in `1.4.x`.\n\n## Token API\n\nVanduo `1.4.1` treats `--vd-*` as the only shipped custom-property namespace:\n\n- Palette: `--vd-red-*`, `--vd-primary-*`, `--vd-gray-*`, and related scales\n- Colors: `--vd-color-*`\n- Backgrounds: `--vd-bg-*`\n- Text: `--vd-text-*`\n- Borders: `--vd-border-*`\n- Shadows: `--vd-shadow-*`\n- Components/effects: `--vd-btn-*`, `--vd-card-*`, `--vd-morph-*`, and related internals\n\nLegacy unprefixed token aliases were removed in `1.4.1`; update custom themes and overrides to use the `--vd-*` equivalents.\n\n```css\n.cta {\n  color: var(--vd-text-inverse);\n  background: var(--vd-color-primary);\n  border-color: var(--vd-border-color);\n}\n```\n\nMore detail lives in [TOKENS.md](TOKENS.md).\n\n## CSS Bundle Notes\n\n- `css/vanduo.css` remains the main framework entrypoint in `1.4.1`.\n- The main bundle still includes framework-wide form defaults for native inputs and textareas.\n- New component styling should prefer `.vd-*` hooks over new raw element selectors.\n\n## Project Structure\n\n```text\nframework/\n├── css/          # Foundation, utilities, effects, components\n├── js/           # Runtime, lifecycle, components\n├── dist/         # Built artifacts\n├── tests/        # Playwright fixtures and specs\n├── scripts/      # Build, verification, and inventory scripts\n└── docs/*.md     # Release and architecture notes\n```\n\n## Development\n\n```bash\ncorepack enable\npnpm install\npnpm run lint\npnpm run build\npnpm run check:versions\npnpm test\npnpm run stats:css\n```\n\n## Release Notes\n\n- Architecture notes: [ARCHITECTURE.md](ARCHITECTURE.md)\n- Token model: [TOKENS.md](TOKENS.md)\n- `1.4.1` token migration notes: [changes-v141.md](changes-v141.md)\n- QA strategy: [QA-Automation-Strategy.md](QA-Automation-Strategy.md)\n- Contributor workflow: [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## License\n\nMIT - see [LICENSE](LICENSE).  \nThird-party notices are listed in [THIRD-PARTY-LICENSES](THIRD-PARTY-LICENSES).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanduo-oss%2Fframework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanduo-oss%2Fframework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanduo-oss%2Fframework/lists"}