Open Source Community

Join the TimeMark Community

TimeMark is built by people like you. Whether you code, design, write, or simply have ideas, there's a way to contribute.

Start Contributing

GitHub Repo

Section

What's in It for You?

Contributing to open-source projects like TimeMark offers benefits beyond altruism.

1. Build Your Portfolio

Real-world experience with Flutter & Dart
Contributions visible on your GitHub profile
Reference-worthy experience for jobs
Collaborate with developers worldwide

2. Learn New Skills

Work with production code
Learn best practices from code reviews
Understand software architecture
Gain experience with Git version control

3. Shape a Tool You Use

Fix the bugs that annoy you
Add features you wish existed
Influence the product roadmap
See your ideas come to life

4. Give Back

Help others improve their productivity
Contribute to the digital wellness movement
Support privacy-respecting software
Be part of something meaningful

5. Join a Community

Connect with like-minded developers
Receive support and mentorship
Make friends with shared interests
Collaborate on a common goal

Section

Ways to Contribute

Pick the path that matches your skills and interests.

1. Code Contributions

Develop Features, Fix Bugs, Improve Performance

What You Can Do

Implement features from the roadmap
Fix open bugs and issues
Optimize performance and reduce resource usage
Refactor code for better maintainability
Add unit and integration tests

Need Ideas?

• Check issues labeled good first issue
• Look for help wanted

Getting Started

1. Fork & Clone the repository.

2. Set Up Environment: Install Flutter/Dart.


flutter pub get
flutter run

3. Create Branch: git checkout -b feature/my-feature

4. Code & Test: Make changes and write tests.

5. Pull Request: Submit with a clear description.

2. Design Contributions

Improve UI/UX, Create Visual Assets

What You Can Do

Design new feature interfaces
Improve existing screens for better usability
Create icons and promotional materials
Develop user flows and wireframes
Conduct usability testing

Tools We Use: Figma, Material Design widgets, Lucide Icons.

Getting Started

Review Current Design by using the app extensively.
Identify Pain Points in the current UI/UX.
Create Mockups using Figma, Sketch, or Adobe XD.
Share Your Designs by opening a GitHub discussion.
Collaborate with developers to implement.

3. Documentation

Write Guides, Improve Docs, Help Users Learn

What You Can Do

Write tutorials and how-to guides
Improve existing documentation
Create video walkthroughs
Write blog posts about using TimeMark
Document undocumented features

Getting Started

Identify documentation gaps by reading current docs.
Write clear content in Markdown.
Include screenshots for visual learners.
Submit via Pull Request to the docs folder.

4. Translation

Make TimeMark Accessible Worldwide

What You Can Do

Translate the app into new languages
Improve existing AI-generated translations
Localize date/time formats
Adapt content for cultural context

Getting Started

1. Check supported languages in the repo.

2. Request new language via Issue if needed.

3. Translate the ARB file: app_en.arb → app_es.arb

4. Test your translation in the app.

5. Submit Pull Request.

5. Testing & Bug Reports

Find Bugs, Test Features, Ensure Quality

What You Can Do

Use TimeMark daily and report bugs
Test new features in beta releases
Reproduce issues others have reported
Test on different Windows versions
Stress-test with large datasets

Getting Started

How to Report Bugs:

Check existing issues to avoid duplicates.
Create New Issue on GitHub with:
Title, Steps to reproduce, Expected vs Actual, Screenshots.
Label appropriately (bug, critical).

6. Community Support

Help Others, Answer Questions, Build Community

What You Can Do

Answer questions in GitHub Discussions
Help troubleshoot issues in forums
Create FAQ entries
Welcome new contributors
Share tips and best practices

Getting Started

Where to Help:

GitHub DiscussionsRedditDiscord

Be patient and kind—everyone starts as a beginner.

7. Spread the Word

Share TimeMark, Help Others Discover It

What You Can Do

Share TimeMark on social media
Write blog posts about your experience
Create video reviews or tutorials
Rate and review on the Microsoft Store

Getting Started

Content Ideas:

"How I Doubled My Productive Time"
"Privacy-Friendly Screen Time Tracking Review"
"5 Focus Mode Tips"

We Appreciate Every Contribution

All contributors are recognized in our CONTRIBUTORS.md file on GitHub. Your contributions—no matter how small—make TimeMark better for everyone.

Hall of Fame

Want to be featured? Start contributing today!

Code of Conduct

TimeMark is committed to providing a welcoming and inclusive environment for everyone, regardless of experience level, gender identity, sexual orientation, disability, physical appearance, race, age, religion, or nationality.

Expected Behavior

Be respectful and considerate
Use welcoming language
Accept constructive criticism
Show empathy toward others

Unacceptable Behavior

Harassment or discrimination
Trolling or insulting comments
Personal or political attacks
Unwelcome sexual attention

Violations can be reported to support@timemark.app. We take all reports seriously.

Your First Contribution

Step 1: Create GitHub Account

It's free and essential for open source.

Step 2: Find an Issue

Look for good first issue or documentation labels.

Step 3: Make Changes

Fork repo, create branch, edit code/docs.

Step 4: Pull Request

Submit your work and celebrate when merged!

Resources

Flutter Docs Dart Language Tour

Every contribution matters

Ready to Make an Impact?

Whether you contribute code, fix a typo, or report a bug—every contribution matters. Start small, learn as you go, and become part of the TimeMark community.

Browse Open Issues