DataManager

This website helps to storage various data types and share it with others. My target is to create fully responsive, functional and scalable ERP-like website based on RWD, MFD, BDD and FDD principles. Serves as my coding sandbox, where I can experiment with different coding techniques, implement new features, and refine my skills.

Join my project and become part of building something incredible!

Live preview

    XAMPP

🛠️ Installation

• First make sure u have installed latest versions of PHP, Laravel, Vue.js, Node.js, npm, XAMPP and Composer

• I recommend use nvm for install latest supported versions of Node.js and npm,

nvm use --lts

• Clone this repository

git clone https://github.com/SzymCode/DataManager.git

• Change .env.example file to .env in root directory

• Generate APP_KEY

php artisan key:generate

• Install modules in root directory

npm install
composer update

# if you want use storybook
cd storybook
npm install

Make sure u have installed all modules!

• run XAMPP mysql server and create database

mysql -u root -p
create database datamanager
create database datamanager_test    # it's not necessary, only for tests

🚀 Run

Root directory:

npm run dev
php artisan serve

❓ Usage

Migrations

php artisan migrate:fresh --seed

# Reset database by dropping all tables and then run all migrations
# --seed flag runs the database seeders after the migrations

Factories

php artisan tinker

# if you wish, you can specify count in factory() or attributes in create()
Article::factory(100)->create();
Contact::factory(100)->create();
User::factory(100)->create();

# for Spatie Activity model
Database\Factories\ActivityFactory::new()->count(100)->create();

Tests

 Pest tests:

# run all tests
./vendor/bin/pest

# or specify group
./vendor/bin/pest --group=api

# defined tests groups:
api, activity-api, article-api, artisan-api, contact-api, sitemap-api, user-api,
database, feature, global, unit, commands, controllers, services, factories, migrations, models

# run all tests and check code coverage
./vendor/bin/pest --coverage

 Cypress tests:

npm run open

 Vitest tests:

npm run test

 Storybook:

cd storybook
yarn storybook

npm

1. Install packages - npm install
2. Vite build - npm run build
3. Run Prettier - npm run write
4. Run Eslint - npm run lint
5. Run Stylelint - npm run slint
6. Husky install - npm run prepare

Sitemaps

Generate XML sitemap

php artisan sitemap:generate

---

    Docker

🛠️ Installation

• First make sure u have installed latest versions of PHP, Laravel, Vue.js, Node.js, npm, Composer and Docker

• I recommend use nvm for install latest supported versions of Node.js and npm,

nvm use --lts

• Clone this repository

git clone https://github.com/SzymCode/DataManager.git

• Change .env.example file to .env in root directory

• Generate APP_KEY

php artisan key:generate

• Install modules in root directory

composer update
php artisan sail:install
sail npm install

# if you want use storybook
cd storybook
npm install

Make sure u have installed all modules!

Possible problems:

• Error: EACCES: permission denied, mkdir '/var/www/html/node_modules': sudo chmod 777 -R DataManager or Solution

🚀 Run

Root directory:

# run Docker containers in the background
sail start

# run command inside laravel.test container bash
sail npm run dev

Remember to shutdown all XAMPP processes!

Possible problems:

• Sail: no such file or directory found: Solution 1, Solution 2
• Error starting userland proxy: listen tcp4 0.0.0.0:3306: bind: address already in use: sudo service mysql stop

❓ Usage

Migrations

sail artisan migrate:fresh --seed

# Reset database by dropping all tables and then run all migrations
# --seed flag runs the database seeders after the migrations

Factories

sail tinker

# if you wish, you can specify count in factory() or attributes in create()
Article::factory(100)->create();
Contact::factory(100)->create();
User::factory(100)->create();

# for Spatie Activity model
Database\Factories\ActivityFactory::new()->count(100)->create();

Tests

 Pest tests:

# run all tests
sail pest

# or specify group
sail pest --group=api

# defined tests groups:
api, activity-api, article-api, artisan-api, contact-api, sitemap-api, user-api,
database, feature, global, unit, commands, controllers, services, factories, migrations, models

# run all tests and check code coverage
sail pest --coverage

 Cypress tests:

npm run open  # For now I've not configured Cypress with Docker

 Vitest tests:

sail npm run test

 Storybook - visit localhost:6006 after sail start

npm

1. Install packages - sail npm install
2. Vite build - sail npm run build
3. Run Prettier - sail npm run write
4. Run Eslint - sail npm run lint
5. Run Stylelint - sail npm run slint
6. Husky install - sail npm run prepare

Sitemaps

Generate XML sitemap

sail artisan sitemap:generate

---

  🛠️   Tech Stack

---

    Contribute

Feel free to check Project and Issues sections.
Your skills and expertise will directly contribute to the success of our project, helping us achieve our goals and create an attractive portfolio.

---

Contributors