Skip to content

Commit 06eec57

Browse files
committed
refact : readme file updated
1 parent 339ea16 commit 06eec57

File tree

1 file changed

+109
-45
lines changed

1 file changed

+109
-45
lines changed

README.md

+109-45
Original file line numberDiff line numberDiff line change
@@ -1,70 +1,134 @@
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+
[![Laravel Version](https://img.shields.io/badge/Laravel-%3E=10.x-red)](https://laravel.com)
6+
[![PHP Version](https://img.shields.io/badge/PHP-%3E=8.1-blue)](https://www.php.net/)
7+
[![License](https://img.shields.io/badge/license-MIT-green)](https://opensource.org/licenses/MIT)
8+
[![Livewire](https://img.shields.io/badge/Livewire-3.0-4B32C3)](https://laravel-livewire.com)
9+
[![Filament](https://img.shields.io/badge/Filament-3.2-orange)](https://filamentphp.com)
10+
[![Jetstream](https://img.shields.io/badge/Jetstream-4.3-blue)](https://jetstream.laravel.com)
211

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
1013

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.
1215

16+
## Table of Contents
1317

18+
- [Features](#features)
19+
- [Requirements](#requirements)
20+
- [Installation](#installation)
21+
- [Usage](#usage)
22+
- [Testing](#testing)
23+
- [Deployment](#deployment)
24+
- [Contribution](#contribution)
25+
- [License](#license)
1426

27+
## Features
1528

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).
1735

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
2537

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
2742

28-
## Learning Laravel
43+
## Installation
2944

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+
```
3150

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+
```
3356

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.
3563

36-
## Laravel Sponsors
64+
4. **Generate application key**:
65+
```bash
66+
php artisan key:generate
67+
```
3768

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+
```
3973

40-
### Premium Partners
74+
6. **Install and configure Jetstream**:
75+
```bash
76+
php artisan jetstream:install livewire
77+
```
4178

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+
```
5583

56-
## Contributing
84+
8. **Seed the database** (optional):
85+
```bash
86+
php artisan db:seed
87+
```
5788

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+
```
5993

60-
## Code of Conduct
94+
## Usage
6195

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.
6399
64-
## Security Vulnerabilities
100+
## Testing
65101
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.
67131
68132
## License
69133
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

Comments
 (0)