Component URLs
A [component URL][glossary.component-url] is a URL that identifies a component.
This section describes the syntax used for displaying URLs to users.
URL Format
A component URL can, in principle, have any [scheme][rfc-uri-scheme]. Some common schemes you may encounter are:
fuchsia-pkg {#fuchsia-pkg}
A fuchsia-pkg component URL is a [package URL][doc-package-url] that locates a
component distributed in a [Fuchsia package][doc-package].
It has the same format as [package URL][doc-package-url], with a
[resource path][doc-package-url-resource-path] relative to the package root that
locates a [component manifest][doc-manifests]. This path is usually of the form
meta/<manifest_name>.cm.
```none {:.devsite-disable-click-to-copy}
fuchsia-pkg://
fuchsia-boot {#fuchsia-boot}
A fuchsia-boot component URL locates a component in the system boot image.
This scheme is used to identify components that must be resolved during early
boot before a fuchsia-pkg [resolver][doc-resolvers] is
available. It has the following format:
```none {:.devsite-disable-click-to-copy}
fuchsia-boot:///
http(s) {#http}
An http(s) component URL identifies a web page as a component. Such a
component could be executed as a web page in a web [runner][doc-runners], for
example.
Example:
```none {:.devsite-disable-click-to-copy} https://en.wikipedia.org/wiki/Hippos
## Relative URLs {#relative}
The Component Framework supports a subset of relative URLs (Relative URLs are
defined in [URL RFC 3986][url-rfc-3986]). Specifically, Component Framework
only supports relative URLs expressed as *URL fragments*. If a relative URL has
any fields set other than the fragment then it will not resolve.
A relative URL resolved at runtime based on the URL of the parent component's
[package][doc-package]. Relative URLs have the following format:
```none {:.devsite-disable-click-to-copy}
#<path-to-manifest>
Example:
```none {:.devsite-disable-click-to-copy}
meta/child.cm
For a `fuchsia-pkg` parent component with the following URL:
```none {:.devsite-disable-click-to-copy}
fuchsia-pkg://fuchsia.com/package#meta/component.cm
The relative URL resolves to:
none {:.devsite-disable-click-to-copy}
fuchsia-pkg://fuchsia.com/package#meta/child.cm
glossary.component-url /concepts/components/v2/component_manifests.md doc-packagedoc-package-urldoc-package-url-resource-path /concepts/components/v2/capabilities/resolvers.md doc-runners[rfc-uri-scheme]: https://tools.ietf.org/html/rfc3986#section-3.1