Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
130 lines (108 loc) · 5.12 KB

CONTRIBUTING.md

File metadata and controls

130 lines (108 loc) · 5.12 KB
Raw

Idea Checklist

Contributing Guide to Idea Checklist

First off, thanks for considering contributing to this project!
Your ideas, time, and effort help make it better for everyone. 🌱

We welcome all kinds of contributions: code, design, documentation, bug reports, feature ideas, and feedback.
This guide explains how you can get involved.

🚀 Ways to Contribute

You don’t need to write code to make a valuable contribution! Here are some great ways:

  • Development – Fix bugs, add features, or refactor code.
  • Testing & Bug Reports – Try the app on different devices and report any issues.
  • Design & UI Feedback – Suggest layout, accessibility, or UX improvements.
  • Feature Requests – Share your ideas for improvements by opening a feature request.
  • Community Support – Answer questions in issues and help others get started.

✅ Pull Request Guidelines

When submitting a PR:

  1. Create a branch from main: 
    git checkout -b <type>/<short-description>
# examples: feature/i18n, fix/typo, i18n/fr-french
  2. Keep commits small and meaningful.
  3. Ensure the app builds and passes linting/tests.
  4. Update docs (README, CHANGELOG) if you changed behavior or added features.
  5. Open the PR and describe what you changed and why..

PR Checklist

  • My changes work locally (npm run dev).
  • I’ve updated documentation/screenshots if needed.
  • I’ve tested on multiple browsers/devices.
  • My commit messages are clear and signed (git commit -s -m "your message").

📝 Commit Convention (Optional but Recommended)

We recommend following the Conventional Commits format:

  • feat: for new features
  • fix: for bug fixes
  • docs: for documentation
  • refactor: for code improvements
  • chore: for maintenance

Example:

feat: add bulk idea selection feature

📦 Development Setup

Important

Before Development, make sure you've installed and updated Rust

  • Check for Rust updates by using rustup update
  • Install The Tauri CLI globally (Optional but Recommended) 
    npm install -g @tauri-apps/cli

If the build fails, make sure you also have required platform dependencies (like Visual Studio Build Tools on Windows, libwebkit2gtk on Linux, or Xcode on macOS).

  1. Fork the repository and clone your fork: 
    git clone https://github.com/ArsenTech/idea-checklist.git
cd idea-checklist
  2. Install dependencies: 
    npm install
  3. Run the development server: 
    npm run tauri dev
  4. Wait until rustup compiles the dependencies, and the window will appear.

PRs are reviewed with kindness and calmness :-)

🧪 Testing

Before submitting a PR:

  • Test light and dark mode.
  • Verify responsiveness and accessibility on desktop.
  • Ensure existing features (like managing ideas and bulk additions), new features, and improvements work correctly.
  • Make sure there are no console errors and no linting issues.

💡 Feedback & Feature Requests

We love new ideas! If you have a suggestion:

  1. Check existing issues
  2. If it’s new, open a feature request.
  3. Explain the motivation and the desired implementation. (the Feature request template says it all ☺️)

🌱 Community Guidelines

We aim to keep this space welcoming and peaceful:

  • Be respectful and constructive.
  • Focus on ideas, not individuals.
  • Keep discussions inclusive and on-topic.
  • Remember: behind every contribution is a person.

Dos and Don'ts

✅ Do ❌ Don’t
Follow branch naming convention Edit README for no reason
Test before submitting Submit broken builds
Use clear commit messages Spam “fix typo” PRs
Respect code owner reviews Bypass linting

See our Code of Conduct for more.

🙌 A Note of Thanks

Contributors are what make this project thrive. Your time, ideas, and creativity are truly appreciated.

Take a deep breath, enjoy the process — and let’s make something beautiful together ✨

Thanks for making Idea Checklist better!

GitHub @ArsenTech  ·  YouTube @ArsenTech  ·  Patreon ArsenTech  ·  ArsenTech's Website