|
1 |
| -<p align="center"><a href="https://laravel.com" target="_blank"><img src="https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg" width="400" alt="Laravel Logo"></a></p> |
| 1 | +# laravel-blog-using-jetstream |
| 2 | + |
| 3 | +# Laravel Blog Project |
| 4 | + |
| 5 | +[](https://laravel.com) |
| 6 | +[](https://www.php.net/) |
| 7 | +[](https://opensource.org/licenses/MIT) |
| 8 | +[](https://laravel-livewire.com) |
| 9 | +[](https://filamentphp.com) |
| 10 | +[](https://jetstream.laravel.com) |
2 | 11 |
|
3 |
| -<p align="center"> |
4 |
| -<a href="https://github.com/laravel/framework/actions"><img src="https://github.com/laravel/framework/workflows/tests/badge.svg" alt="Build Status"></a> |
5 |
| -<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/dt/laravel/framework" alt="Total Downloads"></a> |
6 |
| -<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/v/laravel/framework" alt="Latest Stable Version"></a> |
7 |
| -<a href="https://packagist.org/packages/laravel/framework"><img src="https://img.shields.io/packagist/l/laravel/framework" alt="License"></a> |
8 |
| -</p> |
9 |
| -## About Laravel |
| 12 | +## Overview |
10 | 13 |
|
11 |
| -Laravel is a |
| 14 | +This is a blog application built with **Laravel 10**, integrating powerful tools such as **Filament**, **Livewire**, and **Jetstream**. The project aims to provide a robust and scalable platform for creating and managing blog posts with a user-friendly interface and real-time features. |
12 | 15 |
|
| 16 | +## Table of Contents |
13 | 17 |
|
| 18 | +- [Features](#features) |
| 19 | +- [Requirements](#requirements) |
| 20 | +- [Installation](#installation) |
| 21 | +- [Usage](#usage) |
| 22 | +- [Testing](#testing) |
| 23 | +- [Deployment](#deployment) |
| 24 | +- [Contribution](#contribution) |
| 25 | +- [License](#license) |
14 | 26 |
|
| 27 | +## Features |
15 | 28 |
|
16 |
| -hgdfjhdfweb application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as: |
| 29 | +- **User Authentication**: Secure authentication powered by Jetstream. |
| 30 | +- **Admin Panel**: Manage blog posts, categories, and users through an intuitive admin panel with Filament. |
| 31 | +- **Real-Time Updates**: Dynamic and interactive components utilizing Livewire for a seamless user experience. |
| 32 | +- **Blog Management**: Create, update, delete, and publish blog posts. |
| 33 | +- **Category Management**: Organize blog posts into categories for easy navigation. |
| 34 | +- **User Roles and Permissions**: Role-based access control for different user types (admin, editor, viewer). |
17 | 35 |
|
18 |
| -- [Simple, fast routing engine](https://laravel.com/docs/routing). |
19 |
| -- [Powerful dependency injection container](https://laravel.com/docs/container). |
20 |
| -- Multiple back-ends for [session](https://laravel.com/docs/session) and [cache](https://laravel.com/docs/cache) storage. |
21 |
| -- Expressive, intuitive [database ORM](https://laravel.com/docs/eloquent). |
22 |
| -- Database agnostic [schema migrations](https://laravel.com/docs/migrations). |
23 |
| -- [Robust background job processing](https://laravel.com/docs/queues). |
24 |
| -- [Real-time event broadcasting](https://laravel.com/docs/broadcasting). |
| 36 | +## Requirements |
25 | 37 |
|
26 |
| -Laravel is accessible, powerful, and provides tools required for large, robust applications. |
| 38 | +- PHP 8.1 or higher |
| 39 | +- Composer |
| 40 | +- Node.js & npm |
| 41 | +- MySQL or any other supported database |
27 | 42 |
|
28 |
| -## Learning Laravel |
| 43 | +## Installation |
29 | 44 |
|
30 |
| -Laravel has the most extensive and thorough [documentation](https://laravel.com/docs) and video tutorial library of all modern web application frameworks, making it a breeze to get started with the framework. |
| 45 | +1. **Clone the repository**: |
| 46 | + ```bash |
| 47 | + git clone https://github.com/yourusername/laravel-blog-using-jetstream.git |
| 48 | + cd laravel-blog-using-jetstream |
| 49 | + ``` |
31 | 50 |
|
32 |
| -You may also try the [Laravel Bootcamp](https://bootcamp.laravel.com), where you will be guided through building a modern Laravel application from scratch. |
| 51 | +2. **Install dependencies**: |
| 52 | + ```bash |
| 53 | + composer install |
| 54 | + npm install |
| 55 | + ``` |
33 | 56 |
|
34 |
| -If you don't feel like reading, [Laracasts](https://laracasts.com) can help. Laracasts contains over 2000 video tutorials on a range of topics including Laravel, modern PHP, unit testing, and JavaScript. Boost your skills by digging into our comprehensive video library. |
| 57 | +3. **Set up environment variables**: |
| 58 | + - Copy `.env.example` to `.env`: |
| 59 | + ```bash |
| 60 | + cp .env.example .env |
| 61 | + ``` |
| 62 | + - Update the `.env` file with your database credentials and other environment settings. |
35 | 63 |
|
36 |
| -## Laravel Sponsors |
| 64 | +4. **Generate application key**: |
| 65 | + ```bash |
| 66 | + php artisan key:generate |
| 67 | + ``` |
37 | 68 |
|
38 |
| -We would like to extend our thanks to the following sponsors for funding Laravel development. If you are interested in becoming a sponsor, please visit the Laravel [Patreon page](https://patreon.com/taylorotwell). |
| 69 | +5. **Run migrations**: |
| 70 | + ```bash |
| 71 | + php artisan migrate |
| 72 | + ``` |
39 | 73 |
|
40 |
| -### Premium Partners |
| 74 | +6. **Install and configure Jetstream**: |
| 75 | + ```bash |
| 76 | + php artisan jetstream:install livewire |
| 77 | + ``` |
41 | 78 |
|
42 |
| -- **[Vehikl](https://vehikl.com/)** |
43 |
| -- **[Tighten Co.](https://tighten.co)** |
44 |
| -- **[Kirschbaum Development Group](https://kirschbaumdevelopment.com)** |
45 |
| -- **[64 Robots](https://64robots.com)** |
46 |
| -- **[Cubet Techno Labs](https://cubettech.com)** |
47 |
| -- **[Cyber-Duck](https://cyber-duck.co.uk)** |
48 |
| -- **[Many](https://www.many.co.uk)** |
49 |
| -- **[Webdock, Fast VPS Hosting](https://www.webdock.io/en)** |
50 |
| -- **[DevSquad](https://devsquad.com)** |
51 |
| -- **[Curotec](https://www.curotec.com/services/technologies/laravel/)** |
52 |
| -- **[OP.GG](https://op.gg)** |
53 |
| -- **[WebReinvent](https://webreinvent.com/?utm_source=laravel&utm_medium=github&utm_campaign=patreon-sponsors)** |
54 |
| -- **[Lendio](https://lendio.com)** |
| 79 | +7. **Build assets**: |
| 80 | + ```bash |
| 81 | + npm run build |
| 82 | + ``` |
55 | 83 |
|
56 |
| -## Contributing |
| 84 | +8. **Seed the database** (optional): |
| 85 | + ```bash |
| 86 | + php artisan db:seed |
| 87 | + ``` |
57 | 88 |
|
58 |
| -Thank you for considering contributing to the Laravel framework! The contribution guide can be found in the [Laravel documentation](https://laravel.com/docs/contributions). |
| 89 | +9. **Serve the application**: |
| 90 | + ```bash |
| 91 | + php artisan serve |
| 92 | + ``` |
59 | 93 |
|
60 |
| -## Code of Conduct |
| 94 | +## Usage |
61 | 95 |
|
62 |
| -In order to ensure that the Laravel community is welcoming to all, please review and abide by the [Code of Conduct](https://laravel.com/docs/contributions#code-of-conduct). |
| 96 | +- **Admin Panel**: Accessible at `/admin`, where you can manage posts, categories, and users. |
| 97 | +- **Blog Frontend**: The blog can be viewed at the root URL. Visitors can browse posts by category and search for content. |
| 98 | +- **User Authentication**: Users can register, log in, and manage their profiles using Jetstream's authentication features. |
63 | 99 |
|
64 |
| -## Security Vulnerabilities |
| 100 | +## Testing |
65 | 101 |
|
66 |
| -If you discover a security vulnerability within Laravel, please send an e-mail to Taylor Otwell via [[email protected]](mailto:[email protected]). All security vulnerabilities will be promptly addressed. |
| 102 | +Run the automated tests to ensure that everything is working as expected: |
| 103 | +
|
| 104 | +```bash |
| 105 | +php artisan test |
| 106 | +``` |
| 107 | +
|
| 108 | +For continuous integration, the build status and coverage are tracked using GitHub Actions and Coveralls. |
| 109 | +
|
| 110 | +## Deployment |
| 111 | +
|
| 112 | +For deploying this application to a production server, ensure you have properly set up your environment variables, configured your web server, and optimized your application: |
| 113 | +
|
| 114 | +```bash |
| 115 | +php artisan optimize |
| 116 | +``` |
| 117 | +
|
| 118 | +Consider using services like [Laravel Forge](https://forge.laravel.com/) for easy server management and deployment. |
| 119 | +
|
| 120 | +## Contribution |
| 121 | +
|
| 122 | +Contributions are welcome! Please follow these steps to contribute: |
| 123 | +
|
| 124 | +1. Fork the repository. |
| 125 | +2. Create a new branch (`git checkout -b feature/YourFeature`). |
| 126 | +3. Commit your changes (`git commit -m 'Add some feature'`). |
| 127 | +4. Push to the branch (`git push origin feature/YourFeature`). |
| 128 | +5. Open a pull request. |
| 129 | +
|
| 130 | +Please ensure your code follows the PSR-12 coding standard and includes relevant tests. |
67 | 131 |
|
68 | 132 | ## License
|
69 | 133 |
|
70 |
| -The Laravel framework is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). |
| 134 | +This project is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT). |
0 commit comments