{"id":21976539,"url":"https://github.com/oitcode/samarium","last_synced_at":"2025-04-04T15:05:14.944Z","repository":{"id":37398647,"uuid":"455202212","full_name":"oitcode/samarium","owner":"oitcode","description":"ERP built with Laravel and Livewire. Generate invoice, manage webpages and much more.","archived":false,"fork":false,"pushed_at":"2025-03-31T11:59:26.000Z","size":31377,"stargazers_count":165,"open_issues_count":2,"forks_count":36,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-31T12:35:44.936Z","etag":null,"topics":["bootstrap","contact-form","crm","erp","laravel","livewire","livewire3","newsletter","opensource","php","saas","task-management","vacancy"],"latest_commit_sha":null,"homepage":"","language":"Blade","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oitcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-02-03T14:42:57.000Z","updated_at":"2025-03-31T11:59:29.000Z","dependencies_parsed_at":"2023-10-14T15:54:26.539Z","dependency_job_id":"dee82b27-604f-4d18-8e08-fad4e50ac8f3","html_url":"https://github.com/oitcode/samarium","commit_stats":{"total_commits":2092,"total_committers":6,"mean_commits":348.6666666666667,"dds":0.5219885277246654,"last_synced_commit":"aadd132ecf7e701c25acb6aac23b721e9d507433"},"previous_names":["oitcode/khajanchi","oitcode/cadayor","oitcode/samarium","oitcode/cbswei"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oitcode%2Fsamarium","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oitcode%2Fsamarium/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oitcode%2Fsamarium/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oitcode%2Fsamarium/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oitcode","download_url":"https://codeload.github.com/oitcode/samarium/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247198435,"owners_count":20900079,"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":["bootstrap","contact-form","crm","erp","laravel","livewire","livewire3","newsletter","opensource","php","saas","task-management","vacancy"],"created_at":"2024-11-29T16:10:45.963Z","updated_at":"2025-04-04T15:05:14.938Z","avatar_url":"https://github.com/oitcode.png","language":"Blade","readme":"\u003cdiv align=\"center\"\u003e\n# Samarium\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/samarium-logo-1.png\" alt=\"Samarium ERP logo\"\u003e\n\u003c/div\u003e\n\n\u003chr /\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Version-0.9.4-blue\" alt=\"Version\"\u003e  \u003cimg src=\"https://img.shields.io/badge/PHP-^8.2-474A8A\" alt=\"PHP\"\u003e \u003cimg src=\"https://img.shields.io/badge/Laravel-^11.0-FA5B32\" alt=\"Laravel\"\u003e \u003cimg src=\"https://img.shields.io/badge/Livewire-^3.0-AA3B62\" alt=\"Livewire\"\u003e \u003cimg src=\"https://img.shields.io/badge/Bootstrap-^4.0-AA2BE2\" alt=\"Bootstrap\"\u003e \u003cimg src=\"https://img.shields.io/badge/License-MIT-7b2\" alt=\"License\"\u003e\n\u003c/div\u003e\n\n\u003chr /\u003e\n\nOpen source ERP built with Laravel and Livewire.\n\n## Features\n\nFeature | Description\n------- | -----------\nProduct | Create products from admin panel. This product can be added to invoices as well as displayed in the website.\nProduct Category | Arrange products by product categories. \nInvoicing | Create and manage sale invoice, purchase and expense entries.\nWebsite Management (CMS) | Create and manage webpage and blog post entries.\nCalendar | Create and manage calendar events.\nTeam | Create and manage teams.\nContact Message | View contact messages sent by website visitors \nAppointment | Get appointment request from website visitors. Approve or reject from admin panel.\nNewsletter subscription | Get newsletter subscription request from website visitors.\nTask Manager | Create and manage tasks.\nUsers  | Create and manage users.\n\n![screenshot](screenshots/dashboard-screenshot-1.png)\n\n## Installation\n\nIt is just another laravel application. So we do all the steps required to get a\nlaravel application working. \n\n### Pre requisites\n\nBelow applications must be installed in the system. \n\n```\nphp \u003e= 8.2\nmysql \u003e= 8.0\nnodejs\ncomposer\nnpm\n```\n\n### Step by step instructions\n\nPerform below steps to get the application running.\n\n```\ngit clone https://github.com/oitcode/samarium.git\n```\n\n```\ncd samarium\n```\n\n```\ncp env.example .env\n```\n\nNow create a mysql database. Then grant access to the mysql user. \nLets assume you created database named `demo_database` and you granted\naccess to mysql user `demo_user`. Next, enter database name, mysql username\nand mysql password in the .env file.  Your .env file's database part should\nbe like this.\n\n```\nDB_DATABASE=demo_database\nDB_USERNAME=demo_user\nDB_PASSWORD='demo_password'\n```\nPlease replace `demo_database`, `demo_user` and `demo_password` with real\ndatabase name, username and password.\n\n```\ncomposer install\n```\n\n```\nnpm install\n```\n\n```\nnpm run dev\n```\n\n```\nphp artisan migrate\n```\n\n```\nphp artisan key:generate\n```\n\n```\nphp artisan storage:link\n```\n\n## Database seeding\n\n`php artisan db:seed`\n\nPlease use the database seeding to setup a minimal working dashboard and\nwebsite. Seeder files will create first admin user, basic webpages\nof a typical website - Webpage like About us, Calendar, Noticeboard,\nGallery and Contact us are created - and few other things. Please\ncheck seeder files in `database/seeder` if you want to see what\ndatabase seeding is done.\n \n## Running the app\n\n`php artisan serve`\n\nNow open your web browser and visit \n- `127.0.0.1:8000` to see the website\n- `127.0.0.1:8000/dashboard` to see the dashboard\n\n## Screenshots\n\nBelow are some screenshots.\n\n![screenshot](screenshots/dashboard-screenshot-1.png)\n![screenshot](screenshots/screenshot-product-list-1.png)\n![screenshot](screenshots/screenshot-sale-invoice-list-1.png)\n![screenshot](screenshots/screenshot-sale-invoice-display-progress-1.png)\n![screenshot](screenshots/screenshot-sale-invoice-display-finished-1.png)\n![screenshot](screenshots/screenshot-purchase-list-1.png)\n![screenshot](screenshots/screenshot-customer-display-1.png)\n![screenshot](screenshots/screenshot-daybook-1.png)\n![screenshot](screenshots/screenshot-page-list-1.png)\n![screenshot](screenshots/screenshot-website-homepage-1.png)\n\n## GIFs\n\n![screenshot](screenshots/screenshot-gif-product-1.gif)\n\n![screenshot](screenshots/create-webpage-1.gif)\n\n![screenshot](screenshots/create-post-1.gif)\n\n## Configuration\n\nPlease check `app/config.php` file to see different configuration options\nfor the application. Below are some configuration options you may want to\nchange.  \n\nFile:                    `app/config.php`\nConfigurable option:     `App menu color options`\n\n```\n'app_menu_dropdown_button_text_color' =\u003e 'text-white',\n'app_menu_normal_button_text_color'   =\u003e 'text-white',\n'app_menu_bg_color'                   =\u003e 'bg-dark',\n\n'app_top_menu_bg_color'               =\u003e 'bg-light',\n'app_top_menu_text_color'             =\u003e 'text-dark',\n```\n\n## Contributing\n\nPlease consider contributing to this project. Any kind of contributions are welcome.\nYou can contribute in following ways:\n\nTask    | How to contribute\n------- | -----------\nRaising issues | You can raise issues for existing bugs. Or you can raise issue for requesting new features.\nFixing issues | You can fix issues that are raised here in github repo.\nImplement new feature | You can add new features to this application. Pull requests are welcome.\nRefactor existing feature | Please refactor the code if something can be done better. Pull requests are welcome.\nAdding test code | More test code is needed to automate as much test as possible. You can add more test code. \nImprove documentation | You can help by improving the documentation.\n\n## Issues\n\nIf you find any issue in this application, you can help by raising an issue here in our github repo.\n\n## Support\n\nPlease star this repository to show your support if you find this project useful and/or interesting.\n\n## License\n\n[MIT license](https://opensource.org/licenses/MIT)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foitcode%2Fsamarium","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foitcode%2Fsamarium","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foitcode%2Fsamarium/lists"}