Skip to content

nexoslabs/bot-github-template

Repository files navigation

Probot TypeScript License: MIT

🚀 GitHub Bot Template

This repository provides a robust template for building your own GitHub bot using Probot and TypeScript. The bot automates common workflows like handling issues, pull requests, and notifications while being highly extensible.


🎯 Features

  • 📝 Issue Automation: Automatically triage issues with labels, comments, and assignments.
  • 🔍 Pull Request Workflow: Streamline code reviews with reviewer assignment, comments, and more.
  • 📣 Notifications: Notify contributors and maintainers about important events.
  • 🔧 Extensible and Modular: Easily add new functionality with a service-based architecture.
  • 🌟 TypeScript Support: Take advantage of type safety and modern JavaScript features.

🚀 Getting Started

Follow these steps to get your bot up and running:

Clone the Repository

git clone https://github.com/nexoslabs/bot-github-template.git
cd bot-github-template

Install Dependencies

npm install

Set Up Environment Variables

Create a .env file based on the provided .env.example:

APP_ID=your_app_id
PRIVATE_KEY=path_to_private_key.pem
WEBHOOK_SECRET=your_webhook_secret
GITHUB_TOKEN=your_personal_access_token

Run the Bot

npm start

Expose the Bot (Optional)

Use a tool like ngrok to expose your bot locally:

ngrok http 3000

🛠️ Development

🧪 Testing

Write unit and integration tests to ensure the bot works as expected:

  • Unit tests are located in test/unit/.
  • Integration tests are located in test/integration/.

Run tests with:

npm test

🛡️ Linting

Ensure code quality using ESLint:

npm run lint

🏗️ Build

Compile the TypeScript code to JavaScript:

npm run build

🤝 Contributing

We ❤️ contributions! Follow these steps to contribute:

  1. 🍴 Fork the repository
  2. 🌿 Create a new branch (git checkout -b feature/AmazingFeature)
  3. 💾 Commit your changes (git commit -m 'Add some AmazingFeature')
  4. 🚀 Push to the branch (git push origin feature/AmazingFeature)
  5. 🔃 Open a Pull Request

💡 Acknowledgments

  • Thanks to the Probot team for their amazing framework.
  • Inspired by the open-source community.

📄 License

This project is licensed under The UnLicense See the LICENSE file for details.


📬 Contact & Community

💬 Join us on Discord: Click Here
🐦 Follow on Twitter: @nexoslabs
📧 Email: contact@nexoscreation.tech

Made with ❤️ by the @nexoslabs Team

⭐ Star us on GitHub!

About

Automation bot for github , under maintaince

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages