{"_id":"@aryanjsx/knowindia","_rev":"7-573c92e0b547b9723f178138b7f2cfa5","name":"@aryanjsx/knowindia","dist-tags":{"latest":"1.2.4"},"versions":{"1.2.3":{"name":"@aryanjsx/knowindia","version":"1.2.3","keywords":["aryanjsx","aryan-kumar","india","states","union-territories","capitals","know-india","indian-data","tourism","geography","dataset","npm-package","indian-states","indian-geography","state-codes","ut-codes","regions"],"author":{"name":"Aryan Kumar"},"license":"MIT","_id":"@aryanjsx/knowindia@1.2.3","maintainers":[{"name":"aryanjsx","email":"kumararyan1929@gmail.com"}],"homepage":"https://github.com/aryanjsx/know-india#readme","bugs":{"url":"https://github.com/aryanjsx/know-india/issues"},"dist":{"shasum":"c67ac7cbccab0257f82786561e925d1c34502d34","tarball":"https://registry.npmjs.org/@aryanjsx/knowindia/-/knowindia-1.2.3.tgz","fileCount":46,"integrity":"sha512-gnFBaTXXi/cluACJbpoYt752Xw10EfP4GzkWPKGJl1bbNWW2CjlRVu0w07JsJdDQ29Je3MjXn7JaNckQUqg+dQ==","signatures":[{"sig":"MEQCIHw+ZrYNeaBMpLbSjdaXLuUhSuqvNIWN0HWKGR0EbEOSAiBv1d75oAxIsushIQgPFDwYW2dThsHccqjvdv8mSU0XhA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":154292},"main":"index.js","engines":{"node":">=14.0.0"},"gitHead":"958c49e3c5b6a4c395124e549904e250b38f686b","scripts":{"test":"jest"},"_npmUser":{"name":"aryanjsx","email":"kumararyan1929@gmail.com"},"repository":{"url":"git+https://github.com/aryanjsx/know-india.git","type":"git"},"_npmVersion":"11.6.1","description":"A structured dataset and utility package providing Indian states, union territories, capitals, regions, and metadata for web and backend applications.","directories":{},"_nodeVersion":"24.11.0","_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0"},"_npmOperationalInternal":{"tmp":"tmp/knowindia_1.2.3_1770237609564_0.025927415929246855","host":"s3://npm-registry-packages-npm-production"}},"1.2.4":{"name":"@aryanjsx/knowindia","version":"1.2.4","description":"A structured dataset and utility package providing Indian states, union territories, capitals, regions, and metadata for web and backend applications.","main":"index.js","scripts":{"test":"jest"},"repository":{"type":"git","url":"git+https://github.com/aryanjsx/know-india.git"},"bugs":{"url":"https://github.com/aryanjsx/know-india/issues"},"homepage":"https://github.com/aryanjsx/know-india#readme","keywords":["aryanjsx","aryan-kumar","india","states","union-territories","capitals","know-india","indian-data","tourism","geography","dataset","npm-package","indian-states","indian-geography","state-codes","ut-codes","regions"],"author":{"name":"Aryan Kumar"},"license":"MIT","devDependencies":{"jest":"^29.7.0"},"engines":{"node":">=14.0.0"},"gitHead":"782426989c616172636ba7de6899a0acecf92a1c","_id":"@aryanjsx/knowindia@1.2.4","_nodeVersion":"24.11.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-/Le7BbM99H0YncaecLgAlDp3PENQt1GKUlIJsx/vIhtzd53c+kYYoz10uuGkxGEnCYMKgOUVV0MmaIken/WrbQ==","shasum":"9a912009e540264644b5c9a1fa11cd969772232a","tarball":"https://registry.npmjs.org/@aryanjsx/knowindia/-/knowindia-1.2.4.tgz","fileCount":46,"unpackedSize":154292,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHwU76LG/83q8zeSwG8R92E9q4vbLkhzJYG7Jl35F7A/AiEAljCGbw10x+19loZ/v7GmXx+pZHuHaNXQIJq2GUZMR7U="}]},"_npmUser":{"name":"aryanjsx","email":"kumararyan1929@gmail.com"},"directories":{},"maintainers":[{"name":"aryanjsx","email":"kumararyan1929@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/knowindia_1.2.4_1770237615498_0.39937210202791995"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-04T20:40:09.460Z","modified":"2026-02-04T20:40:15.775Z","1.2.0":"2026-01-09T22:09:08.571Z","1.2.1":"2026-01-09T22:13:44.337Z","1.2.2":"2026-01-10T20:51:00.255Z","1.2.3":"2026-02-04T20:40:09.731Z","1.2.4":"2026-02-04T20:40:15.664Z"},"bugs":{"url":"https://github.com/aryanjsx/know-india/issues"},"author":{"name":"Aryan Kumar"},"license":"MIT","homepage":"https://github.com/aryanjsx/know-india#readme","keywords":["aryanjsx","aryan-kumar","india","states","union-territories","capitals","know-india","indian-data","tourism","geography","dataset","npm-package","indian-states","indian-geography","state-codes","ut-codes","regions"],"repository":{"type":"git","url":"git+https://github.com/aryanjsx/know-india.git"},"description":"A structured dataset and utility package providing Indian states, union territories, capitals, regions, and metadata for web and backend applications.","maintainers":[{"name":"aryanjsx","email":"kumararyan1929@gmail.com"}],"readme":"# Know India 🇮🇳\r\n\r\n[![npm version](https://img.shields.io/npm/v/@aryanjsx/knowindia.svg)](https://www.npmjs.com/package/@aryanjsx/knowindia)\r\n[![License](https://img.shields.io/npm/l/@aryanjsx/knowindia.svg)](https://github.com/aryanjsx/know-india/blob/main/LICENSE)\r\n[![Downloads](https://img.shields.io/npm/dt/@aryanjsx/knowindia.svg)](https://www.npmjs.com/package/@aryanjsx/knowindia)\r\n[![NPM Unpacked Size](https://img.shields.io/npm/unpacked-size/@aryanjsx/knowindia)](https://www.npmjs.com/package/@aryanjsx/knowindia)\r\n[![GitHub stars](https://img.shields.io/github/stars/aryanjsx/know-india)](https://github.com/aryanjsx/know-india/stargazers)\r\n\r\n> A structured dataset and utility package by **[@aryanjsx](https://github.com/aryanjsx)** providing Indian states, union territories, capitals, regions, and metadata for web and backend applications.\r\n\r\n---\r\n\r\n## 📖 Project Overview\r\n\r\n**Know India** is a comprehensive npm package designed to provide structured, reliable data about India's states and union territories. It powers the **Know India** tourism platform and can be seamlessly integrated into dashboards, websites, APIs, and educational applications.\r\n\r\nWhether you're building a travel website, an educational app, a government portal, or any application that requires Indian geographical data, this package provides everything you need in a clean, well-organized format.\r\n\r\n### Who is this for?\r\n\r\n- 🌐 **Web Developers** building tourism or travel websites\r\n- 📊 **Data Analysts** needing structured Indian geographical data\r\n- 📱 **App Developers** creating location-based services\r\n- 🎓 **Educators** building learning platforms about India\r\n- 🏛️ **Government Projects** requiring standardized state/UT data\r\n\r\n---\r\n\r\n## ✨ Features\r\n\r\n| Feature | Description |\r\n|---------|-------------|\r\n| 🗺️ **Complete Coverage** | All 28 Indian states and 8 union territories |\r\n| 🏛️ **Rich Metadata** | Capitals, regions, area, population, languages, and more |\r\n| 🎯 **State Codes** | ISO-standard short codes for each state/UT |\r\n| 🏞️ **Tourism Data** | Tourist attractions, festivals, cuisine, and famous landmarks |\r\n| 📜 **Historical Info** | Brief history and interesting facts for each region |\r\n| 🌸 **State Symbols** | State animals, birds, flowers, and trees |\r\n| 📦 **Zero Dependencies** | Lightweight and fast - no external dependencies |\r\n| 🔧 **Easy Integration** | Works with React, Next.js, Node.js, Express, and more |\r\n| 📝 **Clean JSON Structure** | Well-organized data ready for immediate use |\r\n\r\n---\r\n\r\n## 📦 Installation\r\n\r\nInstall the package using your preferred package manager:\r\n\r\n| Package Manager | Command |\r\n|-----------------|---------|\r\n| **npm** | `npm install @aryanjsx/knowindia` |\r\n| **yarn** | `yarn add @aryanjsx/knowindia` |\r\n| **pnpm** | `pnpm add @aryanjsx/knowindia` |\r\n| **bun** | `bun add @aryanjsx/knowindia` |\r\n\r\n---\r\n\r\n## 🚀 Usage Examples\r\n\r\n### Node.js (CommonJS)\r\n\r\n```javascript\r\nconst { states, uts, India, INDIA } = require('@aryanjsx/knowindia');\r\n\r\n// Get all states data\r\nconst allStates = states();\r\nconsole.log(allStates);\r\n\r\n// Get all union territories data\r\nconst allUTs = uts();\r\nconsole.log(allUTs);\r\n\r\n// Get combined data (states + UTs)\r\nconst indiaData = INDIA();\r\nconsole.log(indiaData);\r\n\r\n// Get quick lookup of all states and UTs\r\nconst lookup = India();\r\nconsole.log(lookup);\r\n```\r\n\r\n### ES Modules (import)\r\n\r\n```javascript\r\nimport { states, uts, India, INDIA } from '@aryanjsx/knowindia';\r\n\r\n// Get specific state data\r\nconst maharashtra = states().MH;\r\nconsole.log(maharashtra);\r\n\r\n// Get specific UT data\r\nconst delhi = uts().DL;\r\nconsole.log(delhi);\r\n```\r\n\r\n### React / Next.js\r\n\r\n```jsx\r\nimport { states, uts } from '@aryanjsx/knowindia';\r\n\r\nfunction StatesList() {\r\n const allStates = states();\r\n \r\n return (\r\n
\r\n {Object.entries(allStates).map(([code, state]) => (\r\n
\r\n

{state.name}

\r\n

Capital: {state.capital}

\r\n

Population: {state.population}

\r\n
\r\n ))}\r\n
\r\n );\r\n}\r\n\r\nexport default StatesList;\r\n```\r\n\r\n### Express.js API\r\n\r\n```javascript\r\nconst express = require('express');\r\nconst { states, uts, INDIA } = require('@aryanjsx/knowindia');\r\n\r\nconst app = express();\r\n\r\n// Get all Indian data\r\napp.get('/api/india', (req, res) => {\r\n res.json(INDIA());\r\n});\r\n\r\n// Get specific state by code\r\napp.get('/api/states/:code', (req, res) => {\r\n const stateData = states()[req.params.code.toUpperCase()];\r\n if (stateData) {\r\n res.json(stateData);\r\n } else {\r\n res.status(404).json({ error: 'State not found' });\r\n }\r\n});\r\n\r\napp.listen(3000, () => console.log('Server running on port 3000'));\r\n```\r\n\r\n---\r\n\r\n## 📊 Data Structure\r\n\r\n### State Data Example\r\n\r\nEach state object contains comprehensive information:\r\n\r\n```javascript\r\n{\r\n name: 'West Bengal',\r\n capital: 'Kolkata',\r\n area: '88,752 km²',\r\n population: '104 million (2023 est.)',\r\n officialLanguages: ['Bengali', 'English'],\r\n literacyRate: '77.9%',\r\n stateAnimal: 'Fishing Cat',\r\n stateBird: 'White-throated Kingfisher',\r\n stateFlower: 'Night-flowering Jasmine',\r\n stateTree: 'Devil Tree',\r\n famousFor: [\r\n 'Howrah Bridge',\r\n 'Victoria Memorial',\r\n 'Sundarbans',\r\n 'Darjeeling Tea'\r\n ],\r\n festivals: ['Durga Puja', 'Kali Puja', 'Poush Mela', 'Rath Yatra'],\r\n cuisine: ['Roshogolla', 'Macher Jhol', 'Shorshe Ilish', 'Sandesh'],\r\n touristAttractions: [\r\n { name: 'Sundarbans National Park', type: 'National Park' },\r\n { name: 'Victoria Memorial', type: 'Historical Monument' },\r\n { name: 'Darjeeling', type: 'Hill Station' },\r\n { name: 'Kalimpong', type: 'Hill Station' }\r\n ],\r\n history: 'West Bengal has a rich history with contributions to literature...',\r\n interestingFacts: [\r\n 'Home to the largest mangrove forest, Sundarbans.',\r\n 'The birthplace of Rabindranath Tagore, Asia\\'s first Nobel laureate.',\r\n 'Known for its vibrant Durga Puja celebrations.'\r\n ]\r\n}\r\n```\r\n\r\n### Union Territory Data Example\r\n\r\n```javascript\r\n{\r\n name: 'Delhi',\r\n capital: 'New Delhi',\r\n area: '1,484 km²',\r\n population: '31.2 million (2023 est.)',\r\n officialLanguages: ['Hindi', 'English', 'Punjabi', 'Urdu'],\r\n literacyRate: '88.7%',\r\n utAnimal: 'Nilgai',\r\n utBird: 'House Sparrow',\r\n utFlower: 'Alamanda',\r\n utTree: 'Jamun Tree',\r\n famousFor: ['India Gate', 'Red Fort', 'Qutub Minar', 'Lotus Temple'],\r\n festivals: ['Diwali', 'Holi', 'Eid', 'Lohri'],\r\n cuisine: ['Chole Bhature', 'Paratha', 'Butter Chicken', 'Biryani'],\r\n touristAttractions: [\r\n { name: 'Red Fort', type: 'Historical Monument' },\r\n { name: 'Qutub Minar', type: 'Monument' },\r\n { name: 'India Gate', type: 'War Memorial' },\r\n { name: 'Lotus Temple', type: 'Temple' }\r\n ],\r\n history: 'Delhi has a storied history, serving as the seat of several empires...',\r\n interestingFacts: [\r\n 'Delhi is the second most populous city in India.',\r\n 'It houses the President\\'s residence, Rashtrapati Bhavan.',\r\n 'Chandni Chowk is one of the oldest and busiest markets in India.'\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## 🔑 API Reference\r\n\r\n### Functions\r\n\r\n| Function | Description | Returns |\r\n|----------|-------------|---------|\r\n| `states()` | Get all Indian states data | Object with state codes as keys |\r\n| `uts()` | Get all Union Territories data | Object with UT codes as keys |\r\n| `INDIA()` | Get combined states and UTs data | `{ states: {...}, uts: {...} }` |\r\n| `India()` | Get quick lookup with state/UT names | `{ allStates: {...}, allUts: {...} }` |\r\n\r\n### State Codes Reference\r\n\r\n#### States (28)\r\n\r\n| Code | State | Code | State |\r\n|------|-------|------|-------|\r\n| AP | Andhra Pradesh | MN | Manipur |\r\n| AR | Arunachal Pradesh | ML | Meghalaya |\r\n| AS | Assam | MZ | Mizoram |\r\n| BR | Bihar | NL | Nagaland |\r\n| CG | Chhattisgarh | OD | Odisha |\r\n| GA | Goa | PB | Punjab |\r\n| GJ | Gujarat | RJ | Rajasthan |\r\n| HR | Haryana | SK | Sikkim |\r\n| HP | Himachal Pradesh | TN | Tamil Nadu |\r\n| JH | Jharkhand | TG | Telangana |\r\n| KA | Karnataka | TR | Tripura |\r\n| KL | Kerala | UP | Uttar Pradesh |\r\n| MP | Madhya Pradesh | UK | Uttarakhand |\r\n| MH | Maharashtra | WB | West Bengal |\r\n\r\n#### Union Territories (8)\r\n\r\n| Code | Union Territory |\r\n|------|-----------------|\r\n| AN | Andaman and Nicobar Islands |\r\n| CH | Chandigarh |\r\n| DN | Dadra and Nagar Haveli and Daman and Diu |\r\n| DL | Delhi |\r\n| JK | Jammu and Kashmir |\r\n| LA | Ladakh |\r\n| LD | Lakshadweep |\r\n| PY | Puducherry |\r\n\r\n---\r\n\r\n## 🌐 Real-World Usage\r\n\r\n> **This package by [@aryanjsx](https://github.com/aryanjsx) is actively used in the [Know India](https://github.com/aryanjsx/know-india) tourism platform to dynamically render state-based content, power location filters, and provide educational information about Indian geography.**\r\n\r\n### Example Use Cases\r\n\r\n- **Tourism Websites**: Display state information, attractions, and travel guides\r\n- **E-commerce Platforms**: State/city selection dropdowns\r\n- **Educational Apps**: Learn about Indian geography and culture\r\n- **Government Portals**: Official state data and statistics\r\n- **Travel Planning Apps**: Destination information and recommendations\r\n- **Data Visualization**: Create maps and charts with Indian data\r\n\r\n---\r\n\r\n## 📋 Versioning\r\n\r\nThis package follows **Semantic Versioning (SemVer)**:\r\n\r\n- **MAJOR** version: Breaking changes (incompatible API changes)\r\n- **MINOR** version: New features (backward compatible)\r\n- **PATCH** version: Bug fixes (backward compatible)\r\n\r\nExample: `1.2.3` = Major.Minor.Patch\r\n\r\n### Version History\r\n\r\nSee [CHANGELOG.md](./CHANGELOG.md) for detailed version history and release notes.\r\n\r\n---\r\n\r\n## 🤝 Contributing\r\n\r\nContributions are welcome! Please read our [Contributing Guide](./CONTRIBUTING.md) for details on:\r\n\r\n- How to submit issues\r\n- How to propose new features\r\n- Code style guidelines\r\n- Pull request process\r\n\r\n### Quick Start for Contributors\r\n\r\n1. Fork the repository\r\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\r\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\r\n4. Push to the branch (`git push origin feature/amazing-feature`)\r\n5. Open a Pull Request\r\n\r\n---\r\n\r\n## 🔒 Security\r\n\r\nFor security concerns, please review our [Security Policy](./SECURITY.md) or report vulnerabilities through GitHub's security advisory feature.\r\n\r\n---\r\n\r\n## 📄 License\r\n\r\nThis project is licensed under the **MIT License** - see the [LICENSE](./LICENSE) file for details.\r\n\r\n---\r\n\r\n## 👨‍💻 Author\r\n\r\n**Aryan Kumar** ([@aryanjsx](https://aryankr.netlify.app))\r\n\r\n- GitHub: [@aryanjsx](https://github.com/aryanjsx)\r\n- npm: [@aryanjsx](https://www.npmjs.com/package/@aryanjsx)\r\n- Twitter: [@aryanjsx](https://twitter.com/aryanjsx)\r\n\r\n---\r\n\r\n## ⭐ Support\r\n\r\nIf you find this package helpful, please consider:\r\n\r\n- ⭐ Starring the [GitHub repository](https://github.com/aryanjsx/know-india)\r\n- 📢 Sharing it with others\r\n- 🐛 Reporting bugs or suggesting features\r\n- 🤝 Contributing to the codebase\r\n\r\n---\r\n\r\n

Made with ❤️ for India by @aryanjsx

\r\n","readmeFilename":"README.md"}