# Hoshi Stars 星 — stars you can see without a telescope, as data and as sky charts > Hoshi 星: stars you can see without a telescope, as data and as sky charts. 5,080 stars with names, distance and colour, the 88 constellations with lines and boundaries, the Messier objects and seven map projections. Typed, no dependencies. Install with `npm install @johnmorrisdotca/hoshi-stars`. Every page below is also an HTML page at the same address ending in .html; the documentation's home is https://johnmorrisdotca.github.io/hoshi-stars/docs/. The examples on the reference pages are run when the site is built, and what they print is shown under them. ## Guides - [Getting started](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/getting-started.md): Look up a star, find its constellation and draw a small sky chart with its lines, in a few minutes and with no dependency. - [The stars](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/stars.md): The 5,080 stars of the Yale Bright Star Catalogue, how to find one by name, number or brightness, what each field means, and how a star moves. - [Colour and distance](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/colour-and-distance.md): Turn a star's colour index into a temperature and a colour to draw, and its parallax into light-years. - [Constellations and their lines](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/constellations-and-lines.md): The 88 constellations by name in English or Japanese, which one a point is in, their boundaries to draw, and a stick figure for each. - [Sky charts](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/sky-charts.md): Put stars, constellation lines and boundaries on a flat chart with the seven projections, and turn a point on the chart back into a point of the sky. - [What is near](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/nearby.md): The stars and Messier objects nearest a star, an object or a point, by angle on the sky or by distance in space, and the constellations that touch a constellation. - [Nearby stars](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/nearby-stars.md): 5,565 more stars with a measured distance and its error, among them Proxima Centauri, Barnard's Star and Wolf 359, as their own import so the bright-star table stays small. - [Plain HTML and a CDN](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/html-and-cdn.md): Draw a sky chart on a page with no build step, from jsDelivr or unpkg, and show a star's facts from a single small import. - [Bundlers](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/bundlers.md): Use the package with Vite or webpack, and keep the bundle to the parts a chart needs. - [Frameworks](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/frameworks.md): Draw a chart in React, Vue, Svelte and Angular, each as one small component that writes the package's SVG. - [TypeScript and Node](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/typescript-and-node.md): The types the package ships, how a wrong projection or a missing star is caught, and drawing the sky on a server. - [Embed a chart in an iframe](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/embed-in-an-iframe.md): Put a sky chart on a page you cannot run script on, by the address of the embed page, and what each part of the address does. - [Data files](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/data-files.md): Download the tables as CSV or Parquet and use them in other languages. - [Serve it yourself](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/serve-it-yourself.md): Run your own small HTTP query service. - [Data and licences](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/data-and-licences.md): Where each part of the data comes from, what each licence lets an MIT package pass on, and what is deliberately left out. - [Troubleshooting and FAQ](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/troubleshooting.md): Fixes for a chart that is empty or upside down, a line across the whole chart, a missing star, a constellation that is not what a book shows, and other questions. - [Upgrading](https://johnmorrisdotca.github.io/hoshi-stars/docs/guides/upgrading.md): What changes between versions, and how a script written for the stars in wakusei-planets moves to this package. ## Reference - [@johnmorrisdotca/hoshi-stars/constellations](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/constellations/index.md): The 88 constellations, in English and Japanese - [@johnmorrisdotca/hoshi-stars/lines](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/lines/index.md): Constellation lines - [@johnmorrisdotca/hoshi-stars/boundaries](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/boundaries/index.md): Constellation boundaries and which constellation a point is in - [@johnmorrisdotca/hoshi-stars/deep-sky](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/deep-sky/index.md): The Messier objects - [@johnmorrisdotca/hoshi-stars/deep-sky/ngc-ic](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/deep-sky-ngc-ic/index.md): NGC and IC objects as well - [@johnmorrisdotca/hoshi-stars/projection](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/projection/index.md): Map projections for sky charts - [@johnmorrisdotca/hoshi-stars/milky-way](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/milky-way/index.md): The Milky Way: a brightness map and soft bands to draw - [@johnmorrisdotca/hoshi-stars/sky](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/sky/index.md): Your sky: altitude and azimuth for a place and a moment - [@johnmorrisdotca/hoshi-stars/nearest](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/nearest/index.md): What is near a star, an object or a point, in the sky and in space; neighbouring constellations - [@johnmorrisdotca/hoshi-stars/nearby](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/nearby/index.md): Nearby stars: Proxima Centauri, Barnard's Star and about 5,600 more, with distance and error - [@johnmorrisdotca/hoshi-stars](https://johnmorrisdotca.github.io/hoshi-stars/docs/api/main/index.md): Stars: names, positions, distance and colour ## Optional - [Changelog](https://johnmorrisdotca.github.io/hoshi-stars/docs/changelog.md): every release - [Every export, in full](https://johnmorrisdotca.github.io/hoshi-stars/llms-full.txt) - [Source](https://github.com/johnmorrisdotca/hoshi-stars)