github.com/ethanbaker/align

Align

Easily schedule nights to meet with friends!

Table of Contents

1. About
   • Built With
2. Getting Started
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About

Align is a scheduling tool that allows users to schedule events with other users. It is designed to be modular, so that users can easily receive schedule reminders and updates through different platforms. Align's uses a configuration file combined with user-controlled sessions to seamlessly integrate with your own custom tools.

Currently, align allows you to contact users through Discord or Telegram. More outreach methods are planned in the future!

Check out align's example usages here.

(back to top)

Built With

• Golang
• Cron
• Discord Go
• Telegram-Bot-API

(back to top)

Getting Started

To get started with align, you can follow one of the ready-made examples here.

The general gist of align is as follows:

• You have a project that utilizes a session (Discord, Telegram, etc)
• You have an align configuration file
• You initialize an align manager using your provided config file that attaches itself to the running session

In doing this, you can attach align ontop of other programs, such as a ready-made Discord/Telegram bot.

(back to top)

Usage

Examples can be found here. Existing examples include:

• Discord Implementation.
• Telegram Implementation.
• Multi-Module Implementation.

These examples show how align can be attached to already-running sessions with an example configuration file.

For more details, please refer to the documentation.

(back to top)

Roadmap

• Allow for different request/response methods
• Add SMS outreach method

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

For issues and suggestions, please include as much useful information as possible. Review the documentation and make sure the issue is actually present or the suggestion is not included. Please share issues/suggestions on the issue tracker.

For patches and feature additions, please submit them as pull requests. Please adhere to the conventional commits. standard for commit messaging. In addition, please try to name your git branch according to your new patch. These standards are a great guide you can follow.

You can follow these steps below to create a pull request:

1. Fork the Project
2. Create your Feature Branch (git checkout -b branch_name)
3. Commit your Changes (git commit -m "commit_message")
4. Push to the Branch (git push origin branch_name)
5. Open a Pull Request

(back to top)

License

This project uses the Apache 2.0 License. You can find more information in the LICENSE file.

(back to top)

Contact

Ethan Baker - [e-mail] - LinkedIn

Project Link: https://github.com/ethanbaker/align

(back to top)

Acknowledgments

• All the friendgroups out there who struggle to connect regularly!

(back to top)