About Feng Shui Life

Feng-shui.life is a Feng Shui calendar web app that works without registration or user accounts. All data — birth year, zodiac sign, theme — is stored exclusively in the browser's local storage (localStorage) and never leaves your device. The app calculates a unique "energy signature" for each day of the year based on two complementary systems: Tong Shu (the Chinese Almanac) and Ba Zi (the Four Pillars of Destiny). The result is a personalised day rating (1 to 5), lucky hours, and a list of auspicious and inauspicious activities — tailored to the user's zodiac sign.

The app's algorithms are based on two ancient Chinese systems: Tong Shu (通書) — The Chinese Almanac with over 4,000 years of history. Each day in the almanac is assigned one of the 12 Day Officers (建除十二神, Jian Chu), the position of one of the 28 Lunar Mansions (二十八宿), and a combination of Heavenly Stems and Earthly Branches (干支). These three systems determine the character of each day — what is auspicious and what to avoid. Ba Zi (八字) — Eight Characters, also known as the Four Pillars of Destiny. The user's zodiac sign is determined from the birth year using the Li Chun date (立春, Start of Spring, ~February 4), not the Chinese New Year. The associated element (Wood, Fire, Earth, Metal, or Water) determines the relationship with the energy of each day. Calculations are performed in real time by the lunar-javascript library — a precise astronomical algorithm for the lunar calendar.

Feng Shui Calendar — a monthly view with a colour-coded rating for each day. Clicking a date opens a full panel with the Day Officer, Lunar Mansion, lucky hours and activity list. Today's Forecast — a personalised summary of the current day with a weekly overview and today's main advice. Date Selector — a tool to find the best days for a chosen type of event: wedding, business opening, moving, investment, medical procedure. The algorithm combines the Day Officer rating with the user's zodiac relationship. Kua Calculator — calculates the personal Kua number (1–9) from birth year and gender, determining auspicious cardinal directions (desk, bed, home entrance). Zodiac Compatibility — a compatibility matrix for all 12 Chinese zodiac signs based on the Six Harmonies (六合) and Three Harmonies (三合) principles. Ba Zi Calculator — generates a full Four Pillars chart with the Day Master (the dominant personality element).

Feng-shui.life is aimed at people interested in traditional Chinese astrology and Feng Shui philosophy. In particular: For planning important dates — couples looking for an optimal wedding date, entrepreneurs choosing a business opening day, people planning a move or renovation. For daily orientation — people who want to consciously manage the energy of the day: when to make decisions, when to rest, when to act actively. For learning — enthusiasts of Chinese astrology and Feng Shui philosophy who want to understand the Tong Shu, Ba Zi and Kua systems in practice.

The feng-shui.life project grew out of a personal fascination with Chinese philosophy of time and planning. It began with reading the classical Tong Shu almanac (通書) — the same book that generations of families in Hong Kong and Singapore consult when choosing a wedding date or business opening day. What struck me was how precise and internally consistent the system is: 12 Day Officers, 28 Lunar Mansions, Year and Month Breakers — each element has a logical basis in Chinese astronomy. The next step was studying Ba Zi (八字), which transforms a date of birth into a map of the five elements. I approached it not as prophecy, but as a language for describing the relationship between time and a person's energy. Combining Tong Shu (general time quality) with Ba Zi (personal time quality) yields a tool of surprising depth. The app began as a private spreadsheet for checking auspicious days for my own decisions. When friends started asking "how did you pick that date?", I decided to build a tool available to everyone — free, without accounts, without data collected on any server.

The feng-shui.life methodology draws on several established sources: Tong Shu Publishing (Hong Kong) — a publishing house producing an annual almanac for over a century. Their edition is widely regarded as the standard reference version of Tong Shu in the Cantonese tradition. Joey Yap and the Mastery Academy of Chinese Metaphysics — one of the most recognised contemporary Feng Shui and Ba Zi masters. His books "Tong Shu Almanac" and Ba Zi courses are a reliable guide to classical interpretation of Day Officers and the Four Pillars. Joey Yap's approach combines the rigour of classical texts with a clear modern presentation. Ken Lai and Practical Chinese Arts — detailed analyses of Xuan Kong Fei Xing (Flying Stars) and zodiac sign compatibility. The lunar-javascript library — an open-source astronomical algorithm for the lunar calendar, which forms the computational foundation of the app. Its precision in calculating Tong Shu dates, Officers and Lunar Mansions is verified by comparison with multiple independent sources. Interpretations in the app are deliberately conservative — we draw on points of agreement between schools, rather than on the divergent interpretations of individual masters.

For privacy matters and general questions: privacy@feng-shui.life The app does not collect personal data on the server side. No user accounts, no database. The only analytics data (Google Analytics 4) is collected only with the user's explicit consent.