Skip to content

Releases: mustbeperfect/definitive-opensource

v0.8.5-beta

24 Jan 17:36

Choose a tag to compare

This release brings about 63 new projects and two major changes; complete refactoring and a switch to UV python tooling.

Refactoring:
We completely redesigned the directory structure to accommodate a monorepo with a Go CLI utility and Vue web client planned for this year. Specifically, a new /apps directory was created and the original /source directory was moved under a new /core directory which includes everything related to the core of the project.

Other minor directory changes include:

  • /components and /data which are not “code” have been moved out of /source to parent /core
  • There are now /dynamic and /static sub-directories within data
  • /readmes is now inside of /resources

UV:
UV has been initialized within /core to handle dependencies and facilitate scalability. We are also using Ruff for linting and formatting. We will likely add a CI pipeline on the GitHub side to use Ruff on push as well, but we'll set this up simultaneously with Go and TS when that code starts being written.

All GitHub action workflows have also been changed to use UV.

New Contributors

v0.7.4-beta

12 Nov 19:01

Choose a tag to compare

This release adds over 157 new projects and introduces new maintenance scripts to help as the list scales.

The first is json_formatter.py that checks applications.json for duplicate projects and makes sure that attributes are filled. It also cross checks the platform and category attribute with their corresponding JSON declaration file to make sure that the inputted categories and platforms actually exist.

The second is status_checker.py that checks for projects that haven't had a commit in the last year, if projects were archived, or if they no longer exist.

Neither of these scripts have the authority to actually fix/change anything, they just generate reports to a MD file as it's important that all critical final decisions are made by humans.

Minor changes:

  • New categories and sub-categories
  • Added static and dynamic sub-directories inside of data/

New Contributors

Full Changelog: v0.6.3-beta...v0.7.4-beta

v0.6.3-beta

31 May 21:01
6dbd431

Choose a tag to compare

Release Note

I've utterly failed to limit the scope of this release. It should have been broken up into 4-5 releases but I got pretty carried away.

The next few versions, which will likely take the project out of beta, will be all about polishing. This was my first open source project so I didn't have much of a plan laid out to follow. I kind of just kept bolting stuff on that I found cool from other projects I was taking inspiration from, making everything messy over time.

This list had around 40 stars as of the last release a couple months ago, but has now surpassed a thousand. This popularity has come with a lot of community input and contributions, which has inspired the fundamental re-imagining of how the list operates.

The list is no longer edited from the README file. We have migrated all applications to an applications.json file. Each application has many properties not visible in markdown like last_commit and language which the web implementation, currently in development, uses. There's also a categories.json and tags.json for declaring organizational properties and tags, respectively. Instead of putting the emoji inside the tags property in applications.json, you use the tag id like commercial These ids are mapped to their emoji. Lastly, platforms.json achieves a similar result to tags.json.

To bring this all together, there are python scripts to generate the main readme, and one readme for the following platforms: Windows, MacOS, Linux, and Selfhosted.

There's also a script to update project properties in the application.json like stars and the description. There's a few projects without or with an irrelevant repository description where we are using the description from their website or README. To prevent the updator script overiding this, we've added the flags attribute to each application.json item. The custom-description flag makes the script skip over the description of that project. More flags will be introduced to cover cases we haven't yet considered.

These scripts are paired with GitHub actions. The updator runs at 12:00 UTC Pacific TIme with README's being generated at 01:00.

Most open source projects fall under two categories: selfhosted or shipping as a desktop app. However a lot of the recent AI utility apps have convoluted or untraditional options for installation, including pip and npm. We initially added the tags npm and pip to convey the installation/runtime, but then realized this was a little too specific. Having pip and npm would also imply we should include tags for cargo, docker, flatpak, rpm, etc. Even though this level of detail would be great, it's not scalable accross the hundreds of project we feature.

We added a Manual tag for apps installed with pip, npm, cargo, or any other form of "manual" installation that isn't what we consider the default; a binary.

We also refactored the platforms and tags system. There used to be lots of items in platforms.json like CLI and Extension. These aren't platforms, they are properties of an app. As such, platforms.json was consolidated to just platforms with the rest being migrated to the properties object of tags.json, with the existing tags going under a new attributes object.

Here's the minor things that have changed:

  • We are no longer using Shields for the star count badge.
  • Most tag emojis were updated for better relevancy
  • Dynamic project count
  • Expanded description
  • Over 200 new projects
  • Added the TUI tag for Terminal User Interface
  • Lots of new categories

New Contributors

v0.5.2-beta

04 Mar 22:26
a92b091

Choose a tag to compare

First time contributor @RedBlackAka with the first contribution #5!

We've made lots of progress! This update brings fundamental changes in structuring, a couple QOL features, contributor resources, and a ton more projects. More details below:

Updates:

  • 🗄️ Added many new categories
  • 📃 90 more projects since the last version
  • 🦮 Built the CONTRIBUTOR.md file where we have established proper conventions and guidelines for the list
  • 🏗️ Remade much of the list to adhere to the new conventions
  • 🧱 Due to increasing scale, the entire list has shifted from being alphabetically to categorically organized with categories and sub categories ordered alphabetically
  • 🏷️ Added Mobile, CLI+, and Extension tags
  • ⬆️ Added "Go to top" button on every category label within the list
  • ❓ Added FAQ
  • 🔗 Added footer with link to the Open Source Initiative
  • 🖥️ Started GitHub deployments for a web page with just the README (still in early stages)
  • 📁 Added _config.yml for deployment configuration

v0.4.2-beta

19 Feb 21:44
100deff

Choose a tag to compare

Now in beta🎉!

Project is decently "stable" and ironed out now.

Major updates:

  • ⭐ Star counts are now retrieved live with shields
  • 🗄️ Added many new categories
  • 📃 Tens of new projects are now on the list for a total of 209. Most major OSS software is now here, but still plenty missing
  • 🏷️ Introduced tags! These are ways to label an important attribute of that specific project, both good and bad
  • 🔖 Platforms are now displayed as tags
  • 🏆 Introduced awards! The first awards will be voted on when the project reaches 1k stars
  • 🦮 Added very detailed guidelines into submission requirements
  • ⚠️ Added issue templates
  • 🗑️ Added archive, a place for projects taken off the list

Minor updates:

  • ⏳ Added total project counter

v0.3.1-alpha

23 Oct 23:02
87beb1b

Choose a tag to compare

What's new:

  • Lots of small fixes and refinements
  • Made two separate table of contents, one categorically organized (default) and another alphabetically organized
  • Organized actual list alphabetically
  • Added several new categories
  • Began work on code of conduct (using contributor convenant as template), contribution guidelines, and roadmap

v0.2.1-alpha

21 Oct 17:01
87beb1b

Choose a tag to compare

What's new:

  • Refined formatting issues and fixed grammatical errors.
  • Changed table of contents order to alphabetical and ordered list based on popularity of the respective category.
  • Added Linux Dashboard category
  • Added Extensions category
  • Added further licensing information

v0.1.0-alpha

16 Oct 01:11
4996e86

Choose a tag to compare

Basic framework of the entire list created and in a semi-publishable state.

In the Alpha stage due to lots of software missing and many polishing edits that need to be made.