core

Vue (published to npm as vue) is a component-based JavaScript framework for building user interfaces, and this repository is where its core source lives. It's aimed at frontend developers who want a framework with a gentle learning curve for small projects that also scales up to full single-page applications, backed by an MIT-licensed open source project with a large, active community.

Key features

• Component-based architecture: UIs are built out of reusable, self-contained components, the model documented across the framework's official guide.
• Reactive state: Vue's core design centers on a reactivity system that keeps the rendered UI in sync with underlying application state.
• Open governance: the project is maintained as an MIT-licensed open source effort, with ongoing development funded by community and corporate sponsors rather than a single company's roadmap.
• Active support channels: an official forum and community chat exist for questions and support, kept separate from the GitHub issue tracker, which is reserved for bug reports and feature requests.
• New issue helper: a dedicated tool guides bug reporters through providing the information maintainers need, and issues that don't follow the guidelines may be closed.
• Curated ecosystem: a community-maintained "awesome-vue" list collects Vue-related projects, components, and tools contributed by the community.
• Transparent contribution process: a published contributing guide documents expectations before a pull request is opened.
• Sponsor-backed development: alongside individual backers, the project lists a Special Sponsor (Better Stack) and a broader set of current sponsors displayed on the official sponsor page.
• Large contributor base: the repository has drawn contributions from hundreds of people; the README notes it displays the first 500 contributors due to GitHub's image rendering limits.

Ideal use cases

This repository is the right place to look if you want to inspect, build, or contribute to Vue's core source, file a bug report or feature request against the framework itself, or check exactly what's shipping in a given version. For actually learning or using Vue in a project, the official documentation at vuejs.org is the intended starting point rather than this source repository directly.

It's not the place to ask general how-do-I-use-Vue questions: the maintainers are explicit that the issue tracker here is exclusively for bugs and feature requests, and point general questions to the official forum or community chat instead. If you're evaluating Vue as a framework choice for a new project, you'll get a much better sense of its APIs and patterns from the documentation site than from browsing this source repository.

Installation

The README defers entirely to the official documentation at vuejs.org for getting started with Vue as a framework. For working on the vuejs/core repository itself (contributing to the framework), the contributing guide linked from the README (.github/contributing.md) is the starting point, and it should be read before opening a pull request.

If you have a Vue-related project, component, or tool you want to share, it can be added to the community-curated awesome-vue list through a pull request to that separate repository.

Because this README intentionally doesn't duplicate framework documentation, anyone new to Vue should start at vuejs.org rather than trying to piece together setup steps from this repository alone.

For staying current with the project outside of code, Vue maintains a presence on X and Bluesky, publishes an official blog, and runs a dedicated Vue job board for teams hiring Vue developers. If you're filing an issue, the project directs you to use its "new issue helper" tool, which walks through the information needed for a useful bug report; issues that skip the expected format may be closed without discussion, so it's worth using the helper rather than opening a blank issue.