crates

Crates is a tool to organize your Spotify library albums into categories or "crates."

Crates lets you organize your albums into custom categories, making it easier to find the perfect soundtrack for any moment. Sync your Spotify library, organize your Crates, and rediscover the joy of full albums curated just the way you like.

Live Version

check out the live version of this running at app.crates.page

TODO

• Library UI - filters: uncrated-only by default
• Library UI - search by title/artist
• Library UI - pull down to sync on mobile (low)
• Library UI - loading state & poll for sync to be done
• Overall - Tabs
• Overall - ngrx state management
• Crates - Better styling on list page (first 4 albums??)
• Crates - search by title / album title
• Crates - Crate settings page (title, public or not, delete crate)
• Crates - A way to remove albums (long press on mobile, X on desktop on hover).
• Crates - how to open in app on desktop (deep link)
• Home - better shit
• Library Sync - stop syncing after first existing is hit
• Library Sync - check for removed albums
• tommy idea - [📦] Create playlists with box icon at the front for each crate.

Building and Running

Requirements

You'll need java, maven, and docker.

Running the Thing

1. Start up the database.

   cd crates-database
   ./mvnw clean install docker:start
2. Setup an application-dev.properties file in the resources folder with your spotify client ID and secret. See application-dev-example.properties for the format.
3. Start up the backend.

   cd crates-backend
   ./restart.sh
4. Start up the frontend.

   cd crates-frontend
   yarn start
5. Open the UI in the browser

Contributing

See CONTRIBUTING.md for details.

License

This project is licensed under the GNU Affero General Public License v3.0. See the LICENSE file for details.