https://github.com/subhadro/fullstack-assignment-for-kamiwaza
https://github.com/subhadro/fullstack-assignment-for-kamiwaza
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/subhadro/fullstack-assignment-for-kamiwaza
- Owner: Subhadro
- Created: 2025-08-04T18:56:32.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-08-04T20:47:12.000Z (11 months ago)
- Last Synced: 2025-08-04T22:20:47.084Z (11 months ago)
- Language: Blade
- Size: 258 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# User Management Dashboard – Fullstack Assignment
This project is a fullstack web application for managing users. It consists of:
- **Frontend**: React (Vite + TailwindCSS)
- **Backend**: Laravel REST API
- **Database**: MySQL
- **API Testing**: Postman Collection included
---
## API Reference
#### Get all users
```bash
GET http://127.0.0.1:8000/api/users
```
#### Get single user
```bash
GET http://127.0.0.1:8000/api/users/${id}
```
| Parameter | Type | Description |
| :-------- | :------- | :-------------------------------- |
| `id` | `string` | **Required**. Id of item to fetch |
#### Save user
```bash
POST http://127.0.0.1:8000/api/users
```
#### Update user
```bash
PUT http://127.0.0.1:8000/api/users/${id}
```
| Parameter | Type | Description |
| :-------- | :------- | :-------------------------------- |
| `id` | `string` | **Required**. Id of item to update |
#### Delete user
```bash
DELETE http://127.0.0.1:8000/api/users/${id}
```
| Parameter | Type | Description |
| :-------- | :------- | :-------------------------------- |
| `id` | `string` | **Required**. Id of item to delete |
## Environment Variables
Edit the .env file with your MySQL database credentials:
`DB_DATABASE=your_db_name`
`DB_USERNAME=your_username`
`DB_PASSWORD=your_password`
## Run Locally
Clone the project
```bash
git clone https://github.com/Subhadro/fullstack-assignment-for-Kamiwaza.git
```
Go to the project directory
```bash
cd fullstack-assignment-for-Kamiwaza
```
Backend – Laravel API
Navigate to the backend directory
```bash
cd user-management-api
```
Install dependencies
```bash
composer install
```
Environment Setup
```bash
cp .env.example .env
php artisan key:generate
```
Migrate and Seed Database
```bash
php artisan migrate
```
Run the Server
```bash
php artisan serve
```
Frontend – React
```bash
cd ../user-management-frontend
```
Install dependencies
```bash
npm install
```
Run the Frontend
```bash
npm run start
```
## API Testing with Postman
```bash
user-management-api/kamiwaza_assignment.postman_collection.json
```