{"id":21342476,"url":"https://github.com/devorein/nishan","last_synced_at":"2025-12-16T06:29:36.095Z","repository":{"id":37825297,"uuid":"306936113","full_name":"Devorein/Nishan","owner":"Devorein","description":"An ecosystem of packages for notion written in typescript.","archived":false,"fork":false,"pushed_at":"2024-11-21T00:58:38.000Z","size":9818,"stargazers_count":171,"open_issues_count":23,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-30T07:32:13.982Z","etag":null,"topics":["monorepo","notion-api","notion-client","notion-wrapper","typescript"],"latest_commit_sha":null,"homepage":"https://nishan-docs.netlify.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Devorein.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-10-24T17:29:36.000Z","updated_at":"2025-01-22T14:00:26.000Z","dependencies_parsed_at":"2024-11-21T01:14:21.145Z","dependency_job_id":null,"html_url":"https://github.com/Devorein/Nishan","commit_stats":null,"previous_names":["devorein/nishan","nishan-open-source/nishan","reinforz/nishan"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devorein%2FNishan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devorein%2FNishan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devorein%2FNishan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Devorein%2FNishan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Devorein","download_url":"https://codeload.github.com/Devorein/Nishan/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247888559,"owners_count":21013001,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["monorepo","notion-api","notion-client","notion-wrapper","typescript"],"created_at":"2024-11-22T01:08:39.557Z","updated_at":"2025-10-25T09:33:58.061Z","avatar_url":"https://github.com/Devorein.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003ca href=\"https://https://nishan-docs.netlify.app/\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e\u003cimg width=\"125\" src=\"https://github.com/Devorein/Nishan/blob/master/docs/static/img/root/logo.svg\" alt=\"Nishan logo\"\u003e\u003c/a\u003e\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e \u003ch1\u003eNishan\u003c/h1\u003e \u003c/div\u003e\n\u003cdiv align=\"center\"\u003e\u003cb\u003eAn ecosystem of packages for notion written in typescript.\u003c/b\u003e\u003c/div\u003e\n\n\u003c/br\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://app.codecov.io/gh/Devorein/Nishan/branch/master\"\u003e\u003cimg src=\"https://img.shields.io/codecov/c/github/devorein/Nishan?color=blue\"/\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/Devorein/Nishan/actions?query=workflow%3A%22Lint%2C+Build+and+Test%22\"\u003e\u003cimg src=\"https://github.com/devorein/nishan/workflows/Lint,%20Build%20and%20Test/badge.svg\"/\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/github/commit-activity/m/devorein/nishan?color=yellow\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/repo-size/devorein/nishan?style=flat-square\u0026color=orange\"/\u003e\n  \u003cimg src=\"https://img.shields.io/github/contributors/devorein/nishan?label=contributors\u0026color=red\"/\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Total%20Packages-32-%2371368a\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Published%20Packages-23-%2311806a\"\u003e\n\u003c/p\u003e\n\nThis monorepo contains/will contain the following packages and apps:-\n\n## Packages\n\n- **`@nishans/cache`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/cache) [NPM](https://www.npmjs.com/package/@nishans/cache): A cache specially designed to retrieve and store notion data in memory\n- **`@nishans/cli`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/cli): A package to interact with `@nishans/core` from the terminal\n- **`@nishans/cms`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/cms): A cms for notion\n- **`@nishans/constants`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/constants) [NPM](https://www.npmjs.com/package/@nishans/constants): A small package for all notion specific constants\n- **`@nishans/core`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/core) [Docs](https://nishan-docs.netlify.app/docs/core) [NPM](https://www.npmjs.com/package/@nishans/core): Unofficial Notion api for node.js with all crud functionalities for Space, User, Block, Page and many more\n- **`@nishans/discord-bot`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/discord-bot): A general purpose discord bot for working with `@nishans/core` from the discord chat textbox\n- **`@nishans/discourse`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/discourse) [NPM](https://www.npmjs.com/package/@nishans/discourse): A package for working with notion discussions \u0026 comments\n- **`@nishans/endpoints`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/endpoints) [Docs](https://nishan-docs.netlify.app/docs/endpoints) [NPM](https://www.npmjs.com/package/@nishans/endpoints): A package to expose all notion endpoints for queries and mutations\n- **`@nishans/errors`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/errors) [NPM](https://www.npmjs.com/package/@nishans/errors): A small package containing various notion specific error classes\n- **`@nishans/extract`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/extract) [NPM](https://www.npmjs.com/package/@nishans/extract): A small package to extract required notion data\n- **`@nishans/fabricator`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/fabricator) [NPM](https://www.npmjs.com/package/@nishans/fabricator): A package to generate notion blocks using a simple api\n- **`@nishans/graphql`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/graphql) [NPM](https://www.npmjs.com/package/@nishans/graphql): A graphql server for notion built using `@nishans/core`\n- **`@nishans/idz`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/idz) [NPM](https://www.npmjs.com/package/@nishans/idz): A small package to validate, generate and parse notion ids\n- **`@nishans/init`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/init) [NPM](https://www.npmjs.com/package/@nishans/init): A package to initialize notion view \u0026 block data\n- **`@nishans/inline-blocks`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/inline-blocks) [NPM](https://www.npmjs.com/package/@nishans/inline-blocks): Package providing an easy to use api to generate contents for notion inline blocks\n- **`@nishans/lineage`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/lineage) [NPM](https://www.npmjs.com/package/@nishans/lineage): A package to work with notion child data\n- **`@nishans/logger`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/logger) [NPM](https://www.npmjs.com/package/@nishans/logger): A logger built specifically for nishan ecosystem\n- **`@nishans/markdown`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/markdown) [Docs](https://nishan-docs.netlify.app/docs/markdown): A package to upload markdown content into notion\n- **`@nishans/notion-formula`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/notion-formula) [Docs](https://nishan-docs.netlify.app/docs/notion-formula) [NPM](https://www.npmjs.com/package/@nishans/notion-formula): A package to generate notion formula with ease\n- **`@nishans/operations`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/operations) [NPM](https://www.npmjs.com/package/@nishans/operations): A package to inspect, modify and store notion operations\n- **`@nishans/orm`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/orm): A package to use notion as a database by providing an easy to use orm api\n- **`@nishans/permissions`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/permissions) [NPM](https://www.npmjs.com/package/@nishans/permissions): A package to easily deal with notion permissions\n- **`@nishans/react-filters`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/react-filters): A react component that emulates notions advanced filter\n- **`@nishans/remark-notion`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/remark-notion): A remark plugin to support custom notion specific syntax for `@nishans/markdown` package\n- **`@nishans/schema-builder`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/schema-builder): A package to create notion collection schema painlessly\n- **`@nishans/sync`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/sync) [Docs](https://nishan-docs.netlify.app/docs/sync) [NPM](https://www.npmjs.com/package/@nishans/sync): A package to keep local notion data in sync with remote one by storing and restoring it\n- **`@nishans/tasks`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/tasks) [NPM](https://www.npmjs.com/package/@nishans/tasks): A package to enqueue and poll notion tasks\n- **`@nishans/traverser`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/traverser) [NPM](https://www.npmjs.com/package/@nishans/traverser): Traverse notion data with ease\n- **`@nishans/typegen`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/typegen): A package to automatically generate typescript definitions from a remote notion collection schema\n- **`@nishans/types`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/types) [Docs](https://nishan-docs.netlify.app/docs/types) [NPM](https://www.npmjs.com/package/@nishans/types): Typescript type definitions for notion\n- **`@nishans/utils`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/utils) [Docs](https://nishan-docs.netlify.app/docs/utils) [NPM](https://www.npmjs.com/package/@nishans/utils): A bunch of small utility modules used across nishans ecosystem\n- **`@nishans/validators`** [Github](https://github.com/Devorein/Nishan/tree/master/packages/validators) [NPM](https://www.npmjs.com/package/@nishans/validators): A group of modules to validate various things related to notion\n\n## Apps\n\nA few apps built/that will be built using the above packages\n\n1.  [markdown-web](https://github.com/Devorein/Nishan/tree/master/apps/markdown-web) (NSY): A react powered web app to upload markdown content as notion pages using `@nishans/markdown`\n2.  [markdown-desktop](https://github.com/Devorein/Nishan/tree/master/apps/markdown-desktop) (NSY): An electron powered desktop app to upload markdown content as notion pages using `@nishans/markdown`\n3.  [markdown-vscode](https://github.com/Devorein/Nishan/tree/master/apps/markdown-vscode) (NSY): A vscode extension to upload markdown content as notion pages using `@nishans/markdown`\n4.  [markdown-native](https://github.com/Devorein/Nishan/tree/master/apps/markdown-native) (NSY): A react native powered mobile app to upload markdown content as notion pages using `@nishans/markdown`\n5.  [notion-formula-web](https://github.com/Devorein/Nishan/tree/master/apps/notion-formula-web) (NSY): A react powered web app to view the generated notion formula ast from array, object or string representation using `@nishans/notion-formula` package\n\n**_NOTE_**: The scope was originally named nishan, but unfortunately that name was already taken in npm. I'll use the term nishan everywhere except in case of the scope, where its nishans.\n\n## Contributors\n\n1.  Safwan Shaheer [github](https://github.com/Devorein) Author, Maintainer\n2.  Matt Casey [github](https://github.com/mattcasey) Contributor\n\n## How to contribute\n\n1.  Clone the repo locally by typing `git clone https://github.com/Devorein/Nishan.git` on the terminal.\n2.  Make sure you have yarn installed\n3.  Install all the dependencies using `yarn install`.\n4.  Run all the tests using `yarn test`.\n\nFeel free to submit a pull request or open a new issue, contributions are more than welcome !!!\n\n## Implementations in other languages\n\n1.  Python: [notion-py](https://github.com/jamalex/notion-py)\n2.  Go: [notionapi](https://github.com/kjk/notionapi)\n3.  Ruby: [notion-ruby](https://github.com/danmurphy1217/notion-ruby)\n4.  Kotlin: [notion-sdk-kotlin](https://github.com/notionsdk/notion-sdk-kotlin)\n\n## Related Projects\n\n1.  [react-notion-x](https://github.com/NotionX/react-notion-x) Fast and accurate React renderer for Notion. TS batteries included.\n2.  [ntast](https://github.com/phuctm97/ntast) Notion Abstract Syntax Tree specification.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevorein%2Fnishan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevorein%2Fnishan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevorein%2Fnishan/lists"}