iztro is a lightweight JavaScript library for generating astrolabes and horoscopes based on Zi Wei Dou Shu, an ancient Chinese astrological system.
The tool solves the problem of calculating and interpreting Zi Wei Dou Shu natal charts programmatically. It generates astrolabes that map celestial positions and Purple Star placements according to this traditional system, then derives horoscope readings and personality analyses from those charts. The library handles the complex astronomical and astrological calculations required to produce accurate charts for a given birth date and time.
Developers building applications that need Chinese astrological functionality should consider this library if they want to avoid implementing Zi Wei Dou Shu calculations from scratch. It suits projects ranging from personal horoscope applications to astrology consultation platforms. The tool emphasizes being lightweight and supporting multiple languages, making it accessible for both Chinese and international audiences. No comparisons to alternative implementations are named in the README.
The project shows active maintenance with regular updates to the codebase. Documentation is comprehensive, with a dedicated homepage providing detailed guidance. The library is written in TypeScript, offering type safety for developers integrating it into their applications.
