Push Express is a tool that simplifies the integration of Push Protocol product components into web projects. Although development began with the implementation of push notification services, it now supports a wide range of Push Protocol functionalities. It allows you to add components and services quickly using TypeScript or JavaScript, with support for Yarn and NPM.
- Adds components for all Push Protocol products with a single command.
- Supports both TypeScript and JavaScript.
- Automatically installs dependencies using Yarn, NPM, or manually.
- Simple integration with Push Protocol to manage Web3 notifications, chats, and more.
To install Push Express, follow these steps:
npm install -g push-express
yarn global add push-express
Once installed, you can use Push Express in your project to add components for Push Protocol products.
Run the following command to add a component:
npx push-express add [component]
or
push-express add [component]
Note: Replace
[component]
with the specific Push Protocol product you want to integrate (e.g.,notification
,chat
, etc.).
After running the previous command, select the file type for your project:
- TypeScript (default)
- JavaScript
After adding the component, Push Express will ask how you want to install the dependencies:
- Yarn: Automatically installs dependencies using Yarn.
- NPM: Automatically installs dependencies using NPM.
- Manual: It will display the command to install them manually.
npm install @pushprotocol/restapi@latest ethers@^5.7
Once the component has been added and the dependencies are installed, you can start your project:
npm run dev
or
yarn dev
Here’s an example of what your project structure might look like after adding a component:
src/
├── components/
│ └── push-notification/
│ ├── index.ts
│ └── push-notification.tsx
└── service/
└── push-notification/
├── index.ts
└── push-notification.service.ts
Contributions are welcome! If you want to contribute to Push Express, follow these steps:
- Fork the project https://github.com/wolfcito/push-express.
- Create a branch for your feature (
git checkout -b feature/new-feature
). - Commit your changes (
git commit -m 'Add new feature'
). - Push to the branch (
git push origin feature/new-feature
). - Open a pull request.
⚠️ Warning:
The code in this repository is provided without any warranties. It is important to note that the code has not been audited for potential security vulnerabilities. Using this code could result in fund loss, compromised data, or asset risks. Proceed with caution and use this code at your own risk. Please refer to the LICENSE file for more details on the terms and conditions.
This project is licensed under the MIT license. For more information, check the LICENSE file.