This repository has been archived on 2024-06-26. You can view files and clone it, but cannot push or open issues or pull requests.
sakura/README.md

36 lines
1.7 KiB
Markdown
Raw Normal View History

2015-04-06 14:26:30 +00:00
# Sakura
2016-03-11 19:26:54 +00:00
![StyleCI](https://styleci.io/repos/45261697/shield)
![SensioLabsInsight](https://insight.sensiolabs.com/projects/6c9b3813-0f50-406c-ab26-665e11876bc9/mini.png)
2015-04-06 14:26:30 +00:00
2016-03-11 19:26:54 +00:00
## Requirements
2016-03-27 22:15:51 +00:00
- PHP 7.0.0 or newer
- A database engine compatible with your PHP install and Laravel/Illuminate's database abstraction layer, MySQL 5.7 recommended.
2016-11-01 17:00:42 +00:00
- [Composer](https://getcomposer.org/)
- [NPM from NodeJS](https://nodejs.org/)
2016-03-11 19:26:54 +00:00
2016-11-01 17:00:42 +00:00
## Installing
### Backend
2016-07-30 13:48:09 +00:00
Copy config.example.ini, set everything up to your liking (database is most important). I'd also recommend setting `show_errors` to `true` for development. Then run the following commands in the root.
```
2016-11-01 17:00:42 +00:00
composer install
2016-07-30 13:48:09 +00:00
php mahou database-install
php mahou database-migrate
php mahou setup
```
After that you can either use `php mahou serve` to use the built in development server or serve the public folder through your webserver of choice.
2016-11-01 17:00:42 +00:00
### Frontend
To compile the LESS and TypeScript assets you need to have the individual compiler installed, both are available from npm and can be installed through the following command:
```
npm install -g less typescript
```
After that install the required libraries by running `npm install` and from then on to compile the files you need to run `build.sh`.
2016-03-11 19:26:54 +00:00
2016-11-01 17:00:42 +00:00
If your editor yells at you that it can't find certain namespaces try running `build.sh` since that generates the required typings (.d.ts files).
## Contributing
2016-03-11 19:26:54 +00:00
Right now I'm not accepting big PRs because of a set of big things not being fully implemented yet, bug fix PRs are more than welcome though!
## License
2016-11-01 17:00:42 +00:00
Sakura is licensed under the Apache License version 2. Check the [LICENSE file](https://github.com/flashwave/sakura/blob/master/LICENSE) for the full thing.