vuejs / vuejs/docs

Document the official MIME type for `.vue` files

Open
#3,352 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

state: awaiting-feedback
Dominant language
Vue
Stars
3.2k
Forks
5k
Avg merge
14d 17h
Merged PRs (30d)
1

Description

I’m working on improving MIME type support for modern web framework source files across tooling, servers, and content-type databases.

Currently, there does not appear to be an officially documented MIME type for .vue files.
Some tools/frameworks use conventions such as text/x-<framework>, but there is no authoritative reference from the Vue project itself.
This create ambiguity for other projects to rely on a consistent mapping.

Having an official statement would help:

  • MIME databases include the mapping
  • web servers and CDNs configure correct content types
  • editors and language servers align
  • reduce ecosystem fragmentation

Would the Vue project be open to document an official recommendation for the MIME type of .vue files?

This does not necessarily require IANA registration though.
A short note in the docs would already provide a reliable reference for downstream projects I think.

If another MIME type from text/x-vue (like text/plain, text/html, text/html+vue, ...) is preferred, documenting that choice would be equally helpful.

Thank you for your work and for considering this!

CC/ @yyx990803

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the Vue documentation for any existing guidance on MIME types for .vue files and compare the conventions cited in the issue. This is done when the project has chosen an official recommendation and documented it clearly for downstream MIME databases, servers, editors, and language servers.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.