diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..8581529
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+Format based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [1.0.0] - 2026-03-31
+
+### Added
+- Complete natal chart casting with Swiss Ephemeris (Sidereal Lahiri)
+- Vimshottari Dasha system (Maha through Prana, 5 levels)
+- Transit overlay with Ashtakavarga scoring
+- Ashtakoot compatibility matching (36-point system with Kuja Dosha)
+- Muhurtha evaluation for 6 activity types
+- D10 Dashamsha career analysis
+- 24 yoga detection types including Pancha Mahapurusha and Raj Yoga
+- Shadbala six-fold strength with Ishta/Kashta Phala
+- Jaimini Karakas (7 Chara Karakas by degree)
+- Bhava Chalit equal-house system
+- Arudha Padas (A1–A12), Upapada, and Karakamsha
+- Kaal Sarpa, Graha Yuddha, and Gandanta detection
+- Planetary Avasthas (BPHS age-states)
+- Sarvashtakavarga, Bhinnashtakavarga, and Prashtara Ashtakavarga
+- Divisional charts: D2, D3, D4, D7, D9, D10, D12, D16, D20, D24, D27, D30, D40, D60
+
+[1.0.0]: https://github.com/adarshj322/dashaflow/releases/tag/v1.0.0
diff --git a/README.md b/README.md
index 70521a6..03240c2 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,10 @@
 # DashaFlow
 
+[![PyPI version](https://img.shields.io/pypi/v/dashaflow)](https://pypi.org/project/dashaflow/)
+[![CI](https://github.com/adarshj322/dashaflow/actions/workflows/ci.yml/badge.svg)](https://github.com/adarshj322/dashaflow/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python](https://img.shields.io/pypi/pyversions/dashaflow)](https://pypi.org/project/dashaflow/)
+
 A Vedic astrology calculation engine for Python, built on the **Swiss Ephemeris** with **Sidereal Lahiri** ayanamsha. Rooted in *Brihat Parashara Hora Shastra* (BPHS) and B.V. Raman's *Hindu Predictive Astrology*.
 
 ```bash