thenextl

πŸ₯— a fresh take on spotify's extremely limited music library

View the Project on GitHub insanj/thenextl

πŸš€ Check out thenextl live!


About

πŸͺ thenextl is built on top of the Spotify Web API using
Bootstrap and JQuery (with help from js-cookie & font-awesome)

πŸ₯‚ thenextl uses Flask and Flask-Freeze to generate a static site</a>
or serve a local webapp for personal use (with help from Make)


What's Included

.
β”œβ”€β”€ app.yaml -- Google Cloud Configuration File
β”œβ”€β”€ build -- Static site ready for serving; can be hosted locally or on Github Pages
β”œβ”€β”€ docs -- Documentation / landing site accessible at https://docs.thenextl.com/
β”œβ”€β”€ init.go -- Google Cloud App file (empty as there is no runtime required for thenextl)
β”œβ”€β”€ main.py -- Flask runtime, used to add new features and drive development; Flask-Freeze uses this to generate the build directory
β”œβ”€β”€ Makefile -- GNU Make recipes to make development easier
β”œβ”€β”€ static -- Webpages and assets that make up all of thenextl
β”‚Β Β  β”œβ”€β”€ css -- CSS layouts for thenextl, includes some customized Bootstrap
β”‚Β Β  β”œβ”€β”€ images -- Image assets
β”‚Β Β  └── js -- JS codebase for thenextl, includes several thenext_WEBPAGENAME.js and thenextl_WEBPAGENAME_runtime.js files
└── templates -- HTML layouts fpr thenextl, built using Bootstrap


Usage

🐏 thenextl uses make to simplify usage, but you can always copy and paste the commands from the recipes below instead for convenience. for lengthy commands, running make setup is usually preferable.


Step Make Command Result
1 setup pip install Flask Frozen-Flask && gcloud init Requires Python, pip, and the Google Cloud SDK already installed. Installs pip packages and begins the Google Cloud App Engine configuration process to host the webapp.
2 freeze rm -r -f build && python main.py build && cd build && python -m SimpleHTTPServer 5000 Builds and runs the webapp locally, using Flask-Freeze to generate a new site. This does not require any Google Cloud configuration.
3 deploy gcloud app deploy Deploys the static site found in the build/ directory to Google Cloud. Ensure the URL Handlers are still working in the app.yaml file. Ideally, renaming the build/ dir to docs/ should allow it to be hosted on Github Pages or any other hosting platform.


License

βš– See LICENSE file for details. Please reach out on Github if you’d like to use thenextl in a project!

TheNextL
Copyright (C) 2016-2018 Julian Weiss

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.