https://github.com/code4romania/bursa-binelui
https://github.com/code4romania/bursa-binelui
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/code4romania/bursa-binelui
- Owner: code4romania
- License: mpl-2.0
- Created: 2023-05-03T15:13:28.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-01-19T15:44:06.000Z (5 months ago)
- Last Synced: 2026-01-19T20:59:15.883Z (5 months ago)
- Language: PHP
- Homepage:
- Size: 5.86 MB
- Stars: 5
- Watchers: 6
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# Bursa Binelui
[![GitHub contributors][ico-contributors]][link-contributors]
[![GitHub last commit][ico-last-commit]][link-last-commit]
[![License: MPL 2.0][ico-license]][link-license]
Insert bullets description of the project if available.
[See the project live][link-production]
Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project.
[Contributing](#contributing) | [Built with](#built-with) | [Repos and projects](#repos-and-projects) | [Deployment](#deployment) | [Feedback](#feedback) | [License](#license) | [About Code for Romania](#about-code-for-romania)
## Contributing
This project is built by amazing volunteers and you can be one of them! Here's a list of ways in [which you can contribute to this project][link-contributing]. If you want to make any change to this repository, please **make a fork first**.
Help us out by testing this project in the [staging environment][link-staging]. If you see something that doesn't quite work the way you expect it to, open an Issue. Make sure to describe what you _expect to happen_ and _what is actually happening_ in detail.
If you would like to suggest new functionality, open an Issue and mark it as a __[Feature request]__. Please be specific about why you think this functionality will be of use. If you can, please include some visual description of what you would like the UI to look like, if you are suggesting new UI elements.
## Built With
### Programming languages
### Platforms
### Frontend framework
### Package managers
### Database technology & provider
## Repos and projects
Mention all related repos and projects.
## Development
### Running the app
- After initial setup (below), run `npm run dev`
- If using Laravel Herd/Valet, access your app in the browser at `https://bursabinelui.test`
- If using the built-in PHP server:
- run `php artisan:serve`
- access your app in the browser at `http://127.0.0.1:8000`
### Initial setup
See initial setup
#### 1. Create local database `bursa_binelui`
#### 2. Copy `.env.example`, rename it to `.env` and fill in your database information
#### 3. Install composer dependencies
```bash
composer install
```
#### 4. Install npm dependencies
```bash
npm install
```
#### 5. Generate the app secret key
```bash
php artisan key:generate
```
#### 6. Migrate and seed the database
```bash
php artisan migrate:fresh --seed
```
> **Note:** Seeding may fail due to underlying issues with Faker date generation. If that happens, just rerun `php artisan migrate:fresh --seed`. Also, seeding can take a while, so be patient.
#### 7. Add the following line to your `.env` file to disable CSP locally
```bash
CSP_ENABLED=false
```
> **Note:** Only for local development!
#### 8. Configure local development URL
#### 8.1. If using Laravel Herd (macOS, Windows)
- **Install Laravel Herd**
Visit [https://herd.laravel.com](https://herd.laravel.com) and download the installer for macOS or Windows
- **Open your project with Herd**
- Launch Herd. Go to `Sites`. Go to `Add Sites`. Go to `Link existing project`. Select the project. Select the `PHP version` and `enable HTTPS`. Click `Next`
- 
#### 8.2. If using the built-in PHP server
- In your `.env` file, update `APP_URL` to `APP_URL=http://127.0.0.1:8000`
## Deployment
Guide users through getting your code up and running on their own system. In this section you can talk about:
1. Installation process
2. Software dependencies
3. Latest releases
4. API references
Describe and show how to build your code and run the tests.
## Feedback
* Request a new feature on GitHub.
* Vote for popular feature requests.
* File a bug in GitHub Issues.
* Email us with other feedback contact@code4.ro
## License
This project is licensed under the MPL 2.0 License - see the [LICENSE](LICENSE) file for details
## About Code for Romania
Started in 2016, Code for Romania is a civic tech NGO, official member of the Code for All network. We have a community of around 2.000 volunteers (developers, ux/ui, communications, data scientists, graphic designers, devops, it security and more) who work pro-bono for developing digital solutions to solve social problems. #techforsocialgood. If you want to learn more details about our projects [visit our site][link-code4] or if you want to talk to one of our staff members, please e-mail us at contact@code4.ro.
Last, but not least, we rely on donations to ensure the infrastructure, logistics and management of our community that is widely spread across 11 timezones, coding for social change to make Romania and the world a better place. If you want to support us, [you can do it here][link-donate].
[ico-contributors]: https://img.shields.io/github/contributors/code4romania/bursa-binelui.svg?style=for-the-badge
[ico-last-commit]: https://img.shields.io/github/last-commit/code4romania/bursa-binelui.svg?style=for-the-badge
[ico-license]: https://img.shields.io/badge/license-MPL%202.0-brightgreen.svg?style=for-the-badge
[link-contributors]: https://github.com/code4romania/bursa-binelui/graphs/contributors
[link-last-commit]: https://github.com/code4romania/bursa-binelui/commits/main
[link-license]: https://opensource.org/licenses/MPL-2.0
[link-contributing]: https://github.com/code4romania/.github/blob/main/CONTRIBUTING.md
[link-production]: insert_link_here
[link-staging]: insert_link_here
[link-code4]: https://www.code4.ro/en/
[link-donate]: https://code4.ro/en/donate/