{"id":20810872,"url":"https://github.com/elvisans/larablog","last_synced_at":"2025-04-09T23:13:33.075Z","repository":{"id":132784875,"uuid":"527476160","full_name":"ElvisAns/LaraBlog","owner":"ElvisAns","description":"A simple fullstack blog system","archived":false,"fork":false,"pushed_at":"2022-08-30T20:44:48.000Z","size":1278,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-09T23:13:22.134Z","etag":null,"topics":["fullstack-development","laravel","single-page-applications","vuejs"],"latest_commit_sha":null,"homepage":"lara-blog.vercel.app","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ElvisAns.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-08-22T08:30:05.000Z","updated_at":"2024-01-25T16:50:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"2fe808c9-c7f9-4c66-8f61-5c783951747c","html_url":"https://github.com/ElvisAns/LaraBlog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElvisAns%2FLaraBlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElvisAns%2FLaraBlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElvisAns%2FLaraBlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ElvisAns%2FLaraBlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ElvisAns","download_url":"https://codeload.github.com/ElvisAns/LaraBlog/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248125589,"owners_count":21051770,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fullstack-development","laravel","single-page-applications","vuejs"],"created_at":"2024-11-17T20:28:30.676Z","updated_at":"2025-04-09T23:13:33.056Z","avatar_url":"https://github.com/ElvisAns.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"https://user-images.githubusercontent.com/35831811/186013587-ff898e23-1c50-4465-9e4a-9829ec4f872f.png\"\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n    BUILT WITH\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e \n       \u003cimg src=\"https://raw.githubusercontent.com/laravel/art/master/logo-lockup/5%20SVG/2%20CMYK/1%20Full%20Color/laravel-logolockup-cmyk-red.svg\" width=\"200\"\u003e              \u003cimg src=\"https://positivethinking.tech/wp-content/uploads/2021/01/Logo-Vuejs.png\" width=\"100\"\u003e\n\u003c/p\u003e\n\n# LaraBloG\n\nWelcome here!\n\n![Vercel](http://therealsujitk-vercel-badge.vercel.app/?app=lara-blog)\n\nThe api is proudly served by \u003cb\u003ehttps://render.com/\u003c/b\u003e (from a docker service + a postgres database)\n\n\u003chr/\u003e\n\nThis is another awesome blogging web application running on top of laravel and vue!\n\nWe adopted to completely separate backend and frontend in order to explore the\nthe power and extensibility of both frameworks (note that we could have compiled the vue components\nin blade templates but that's not my favorite way to do it :haha )\n\nHere's why separating things is the right idea:\n\n- The same exposed API endpoint can serve multiple purposes i.e. mobile app, web app and any other API consumer\n- We fully explore the power of Vue SPA with all the benefits of SPAs\n- The frontend can be deployed anywhere as a static site\n- Single Page applications are fast!\n\n\n## Features (MVP)\n\n- Website Responsivess\n- User authorization and authentication\n- Blog creation, edition and deletion\n- Cross platform access\n\n\n## Getting started\n\nIn order to run this project on your local environment ensure you have the following tool installed:\n - PHP (At least PHP 7.3) and make sure you can access it globaly in your terminal https://kinsta.com/blog/install-php/\n- Composer for PHP package management https://getcomposer.org/\n- A SQL database Management system (We have prefered MySQL) https://www.mysql.com/fr/downloads/\n- NPM \u0026 Node JS https://nodejs.org/en/\n- Vue-CLi (optional) https://cli.vuejs.org/guide/\n- Git bash https://git-scm.com/downloads\n\nBefore you continue make sure you can run the following\n```bash\n  php --version\n```\n```bash\n  node --version\n```\n```bash\n  npm --version\n```\n```bash\n  composer --version\n```\n```bash\n  mysql --version\n```\n```bash\n  git --version\n```\nIn case one this command rise an error, please address the issue before continue\n\n# Installation\nFirst you have to clone the project in a given folder on your local machine by\n\n```bash\n  git clone https://github.com/ElvisAns/LaraBlog.git \n```\n\nThen navigate inside the folder and run\n(Make sure you are having composer 2.x) to avoid error on runing composer install\n\n```bash\n  composer install\n```\n```bash\n  cd frontend\n```\n```bash\n  npm install\n```\n\nThe root folder contain our main backend application (laravel) while inside the frontend\nfolder we have our vue application \n\nIn both root and frontend you will found a file **.env.example**, rename them as **.env** and start using\nthem as template.\n\nWhile the frontend **.env** file can be left as is, the laravel **.env** file(from the root folder) need\nto be adjusted to your local setup.\n\nOpen it and make sure the database credentials are correctl .\n\n**we assume you have already created \nan empty database so you can use it inside the .env config at root(laravel env).if no, check on this [blog](https://www.inmotionhosting.com/support/server/databases/create-a-mysql-database/)**\n\nNext\n____\n\nBeing in the root folder run the following command:\n\n```bash\n  php artisan migrate\n```\nThis command will first check if the app can access the database you have configured and if so,\nit will create necessary tables for us!\n\n*Cool, Dont you see? hahhaa*\n\nNext if, migration successed you can seed your database with mock datas as many time as you want \nby running \n\n```bash\n  php artisan db:seed\n```\nNow our app backend is ready, you can start the server by running\n\n```bash\n  php artisan serve\n```\n\nExcited to get started? Please continue reading!\nTo now serve our frontend, make sure the php artisan serve is keeping running!\nIf you are using VS Code you can easily open two terminal windows.\n\nNow open a new terminal and move inside the frontend folder and run the following command\n\n```bash\n  npm run serve\n```\n\nBingo!!!\n\nIf you did not change any configuration about urls you can access the website at **http://localhost:8080/** \n\nEnjoy!\n\n\n![image](https://user-images.githubusercontent.com/35831811/186032058-27a4e1e7-703e-4f53-bcfd-e4e49a572327.png)\n\n\nRemember that anytime you need to add new mock datas inside the database, you can always run **php artisan db:seed**\nand the terminal will show the user account created so you can easily login without having to signup directly from the website.\n\nPlay around with this MVP website with simple yet powerfull blog feature!\n\n\n\n\n    \n## Running Tests\n\nTo run tests against our backend api, run the following command at root (Our tests has been defined as feature so we need --testsuite=Feature)\n\n```bash\n  php artisan test --testsuite=Feature\n```\nAttention : Running test will wipe all the datas inside the database, so make sure\nyou seed the database after perfoming tests!\n## TODO\n\nThere are still some functionalities that we are planning to implement soon:\n- Comments features\n- User access capacity (admin,publisher, reviewer etc..)\n- A nice text editor plugin\n- Enhance profile component and make it look like a dashboard\n\n\n**And many more that i didn't spot, right?**\n\n\n## Contributing\n\nif you answered `YES!` come and join me building amazing blog website :-)\n\nFeel free to fork the repo, report any bug, propose a feature so  we make it better!\n\nEmail me at ansimapersic@gmail.com\n\n\u0026copy; 2022 -  [ElvisAnsima](https://github.com/ElvisAns)\n\n--\nPLAY THE HARD GAME\n--\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felvisans%2Flarablog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Felvisans%2Flarablog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Felvisans%2Flarablog/lists"}