README

Blog Using Laravel 11

Let's keep it as simple as possible. Configure anything you want

A full-featured blogging system for personal use. No frontend theme and anything heavy or unnecessary library used.

Technologies used

1. TailwindCSS
2. Alpine.js
3. Laravel
4. Livewire

There are four several types of users with several permissions

1. Admin/Owner

• Can be accessed in <url>/admin/login
• Can manage articles and comments of other users.
• Can manage categories.
• Can manage keywords.
• Can manage other users except Owner.

1. Reader

• Can read and comment on article providing his email address.
• Can subscribe to be notified for new articles.
• Can search for articles.
• Can navigate articles based on categories.

Installation Process

Option 1: Docker Installation (Recommended) 🐳

1. Prerequisites: Install Docker and Docker Compose
2. Clone the repository:

   git clone https://github.com/alimranahmed/LaraBlog.git
   cd LaraBlog

3. Quick setup with a script:

   ./run composer install
   ./run npm install
   ./run npm run build
   ./run php artisan key:generate
   ./run php artisan migrate --seed

4. Visit http://localhost:1013 - It's running! 🎉
5. Access Mailpit (email testing): http://localhost:1028

Tip: Use ./run php artisan [command] to run any artisan command

📖 For detailed Docker documentation, see DOCKER.md

Option 2: Traditional Installation

1. Execute git clone https://github.com/alimranahmed/LaraBlog.git on your terminal to download this project.
2. Go to the project root directory and execute composer install to install all PHP dependencies of the project
3. Create a file named as .env and copy the content of .env.example to a newly created .env file
4. Then execute php artisan key:generate on your terminal/cmd to generate an environment key
5. Then create a Database for this project and edit the .env file to authorized this project on your database.
6. Execute php artisan migrate:refresh --seed terminal on your terminal.
7. Now you are ready to go, If you don't want to create any virtual host for this project then execute php artisan serve
8. Now visit the url shown on your terminal, something like localhost:8000. It's running!

Note: After migration and seeding, to login as admin/owner using the following credentials:

Email: owner@gmail.com
Password: owner

Sample Blog

1. https://imranic.com

Contribution

Anyone is always welcome to contribute on the project. If you want to work with:

1. Just create an issue(even if you want to fix the issue).
2. After fixing any issue or adding any new feature just send a pull request.
3. I will be happy to add your code in order to enhance this project. Thanks.

License

MIT