Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oitcode/samarium
Open source ERP plus Content Management System (CMS) built with Laravel and Livewire. You can create webpages and blog posts easily from easy to use admin panel. Apart from CMS, there are also other features like product display, invoice creation, calendar events, contact message, task manager, document sharing etc.
https://github.com/oitcode/samarium
blogging bootstrap calendar calendar-events cms contribute-here contribute-repository document-sharing ecommerce ecommerce-platform erp erp-application laravel livewire open-source php product product-catalog task-management tasks
Last synced: about 1 month ago
JSON representation
Open source ERP plus Content Management System (CMS) built with Laravel and Livewire. You can create webpages and blog posts easily from easy to use admin panel. Apart from CMS, there are also other features like product display, invoice creation, calendar events, contact message, task manager, document sharing etc.
- Host: GitHub
- URL: https://github.com/oitcode/samarium
- Owner: oitcode
- License: mit
- Created: 2022-02-03T14:42:57.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-12T07:13:09.000Z (about 1 month ago)
- Last Synced: 2024-12-12T08:18:11.616Z (about 1 month ago)
- Topics: blogging, bootstrap, calendar, calendar-events, cms, contribute-here, contribute-repository, document-sharing, ecommerce, ecommerce-platform, erp, erp-application, laravel, livewire, open-source, php, product, product-catalog, task-management, tasks
- Language: Blade
- Homepage:
- Size: 10.1 MB
- Stars: 47
- Watchers: 7
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Samarium
Open source ERP plus Content Management System (CMS) built with Laravel and Livewire.
You can create webpages and blog posts easily from easy to use admin panel. Apart from CMS,
there are also other features like product display, invoice creation,
calendar events, contact message, task manager, document sharing etc.
## Built with
## Features
- Content Management System (CMS)
- Ecommerce support
- Product Catalogue
- Invoice Generation
- Calendar Events
- Team Catalogue
- Contact Message
- Appointment Scheduler
## Installation
It is just another laravel application. So we do all the steps required to get a
laravel application working.
### Pre requisites
Below applications must be installed in the system.
```
php >= 8.1
mysql >= 8.0
composer
npm
```
### Step by step instructions
Perform below steps to get the application running.
First create a mysql database. Then grant access to the mysql user.
Lets assume you created database named `demo_database` and you granted
access to mysql user `demo_user`. You will need this info to enter
in the .env file later.
Clone the repository.
```
$ git clone https://github.com/oitcode/samarium.git
```
Go to the directory.
```
$ cd samarium
```
Copy env.example file to .env file
```
$ mv env.example .env
```
Now, enter database name, mysql username and mysql password in the .env file.
Your .env file's database part should be like this.
```
DB_DATABASE=demo_database
DB_USERNAME=demo_user
DB_PASSWORD='demo_password'
```
Please replace `demo_database`, `demo_user` and `demo_password` with real
database name, username and password.
Install composer dependencies.
```
$ composer install
```
Install npm dependencies.
```
$ npm install
```
Compile front end assets.
```
$ npm run dev
```
Run database migrations.
```
$ php artisan migrate
```
Generate key.
```
$ php artisan key:generate
```
Create storage links.
```
$ php artisan storage:link
```
### Script installation
If you do not want to perform all the installation steps manually,
then there is a bash script provided that will run all the
required steps.
Please run below bash script.
`bash app-install.sh`
## Creating first user
To use the dashboard, you need a username and password.
Use below seeder file to create first user. This will create
an admin user. After that you can create other users from
dashboard.
`php artisan db:seed --class=UserSeeder`
## Running the app
`php artisan serve`
Now open your web browser and visit
- `127.0.0.1:8000` to see the website
- `127.0.0.1:8000/dashboard` to see the dashboard
## Usage
Below are screenshots of most used functionalities.
### Create a webpage
### Create a post
## Contributing
__Please contribute to this project.__
Contributions are welcome.
## Issues
If you find any issue in this application, you can help by raising an issue
here in our github repo.
## License
[MIT license](https://opensource.org/licenses/MIT).