Thank you for your interest in contributing to SpaceGuard! SpaceGuard is an open-source project dedicated to providing lightweight disk space and dependency management for Debian, Kali Linux, Ubuntu, and macOS systems.
- Search existing issues to ensure the bug hasn't been reported yet.
- Open a new issue with a clear title, description, steps to reproduce, and your system environment (e.g., Debian 12, Kali 2024.1, macOS Sequoia / Sonoma).
- Feature requests are welcome! Please open an issue outlining the motivation and proposed implementation.
- Fork the repository on GitHub:
https://github.com/MutantMonx/SpaceGuard.git. - Create a feature branch:
git checkout -b feature/my-new-feature. - Commit your changes with descriptive commit messages.
- Test your changes locally (
npm run lintandnpm run build). - Push to your branch and submit a Pull Request.
- Use TypeScript with strict type safety where possible.
- Use Tailwind CSS for utility styling matching the geometric cyberpunk/terminal aesthetic.
- Ensure all user-facing strings are added to
src/utils/translations.tsfor EN/PL localization.
By contributing to SpaceGuard, you agree that your contributions will be licensed under the Apache License 2.0.