ListPal is a web app that lets you create easily shareable to-do lists that automatically stay in sync and display updates in real time. It's currently powered by:
This repo is currently what powers the main app at listpal.co. You can also choose to clone this repository and run on your own server by following the steps below.
This app is currently powered by Laravel 5.8, and as such follows their requirements for proper installation. Your server will need to meet the following conditions:
- PHP >= 7.1.3
- BCMath PHP Extension
- Ctype PHP Extension
- JSON PHP Extension
- Mbstring PHP Extension
- OpenSSL PHP Extension
- PDO PHP Extension
- Tokenizer PHP Extension
- XML PHP Extension
In addition to the above, if you'll be modifying any styles or JavaScript, you will need to have both Node.js and NPM installed (preferably with their latest up-to-date versions).
After cloning this repo to your desired location, complete the following steps:
- Run
composer install. - Run
npm install. - Copy
.env.exampleto.envand add in your database and app name details. - Run
php artisan migrateto add in the database structure. - Run
php artisan websockets:serveto start the laravel-websockets server. - Visit the website!
If you make any modifications to the styles, images, or JavaScript in the /assets/ directory, you'll need to recompile them through Laravel's Mix webpack wrapper. From the root directory, simply run either:
npm run devfor fast compilation during local developmentnpm run productionto minify and transpile assets for production deployment
ListPal is still very much in active development, and as such bugs and feature requests might be pretty common. If you'd like to contribute to the app's development, please feel free to open a pull request resolving an issue or adding in a requested feature!
If you have any questions or concerns, you can reach out directly via Twitter or through email.
ListPal is open-source software licensed under the MIT license.