Dokumentasi Project

FullStackJS Express + React

REST API dengan Express, Prisma & MySQL dan aplikasi React dengan login JWT serta manajemen user

Versi 1.0 · November 2026 · Project pembelajaran

Ringkasan eksekutif

FullStackJS Express + React adalah project full-stack JavaScript untuk pemula: REST API dengan Express, Prisma, dan MySQL, serta aplikasi React (single-page) untuk registrasi, login dengan JWT, dan mengelola user lewat area admin yang terproteksi.

Repositori ini juga berisi FundamentalES6, kumpulan latihan kecil JavaScript modern yang menjadi dasar project ini.

7endpoint REST
7halaman React
JWTautentikasi (1 jam)
23latihan ES6

Buka demo live →

Fitur

Registrasi & login

Daftar dengan nama, e-mail, dan password; login untuk mendapatkan JWT yang disimpan di cookie.

Route terproteksi

Halaman admin mengarahkan ke login jika tidak ada token; API menolak request tanpa token yang valid.

Kelola user (CRUD)

Lihat, tambah, ubah, dan hapus user dari area admin.

Validasi di server

express-validator mengecek field wajib, format e-mail, e-mail unik, dan panjang password.

Hash password

Password di-hash dengan bcrypt sebelum disimpan.

Demo live

Aplikasi React asli berjalan di GitHub Pages dengan backend yang disimulasikan di browser.

Arsitektur

Frontend · React + Vite Backend · Express (port 3000) Data Halaman (react-router)Home · Register · Login · Dashboard · Users AuthContext + js-cookietoken & user disimpan di cookie services/api.js (axios)baseURL http://localhost:3000 mockApi.js · khusus demoaturan sama, jalan di browser routes/index.js/api/register · /api/login middlewares/auth.jsverifikasi JWT utils/validators · express-validatornama, format & keunikan e-mail, password ≥ 6 controllers · Register · Login · Userbcryptjs · jsonwebtoken (1h) Prisma Clientprisma/schema.prisma · migrations MySQLdb_express · users localStoragedata demo
Di lokal, aplikasi React memanggil API Express di port 3000. Pada demo live, request yang sama dijawab oleh mockApi.js di dalam browser.
LapisanTeknologiFolder
FrontendReact 18, Vite 5, react-router-dom 6, axios, js-cookie, Bootstrap 5frontend-react/
BackendExpress 4, express-validator, bcryptjs, jsonwebtoken, cors, body-parserbackend-express/
DatabaseMySQL + Prisma ORMbackend-express/prisma/
LatihanJavaScript ES6+ (Node.js)FundamentalES6/

Referensi API

Base URL http://localhost:3000. Endpoint terproteksi membutuhkan JWT di header Authorization (token langsung, tanpa “Bearer”).

MethodEndpointAuthBodySukses
POST/api/register—name, email, password201 Register successfully
POST/api/login—email, password200 { user, token }
GET/api/admin/usersJWT—200 daftar user (terbaru dulu)
POST/api/admin/usersJWTname, email, password201 User created successfully
GET/api/admin/users/:idJWT—200 { id, name, email }
PUT/api/admin/users/:idJWTname, email, password200 User updated successfully
DELETE/api/admin/users/:idJWT—200 User deleted successfully

Respons error

HTTPKapanBody
422Validasi gagal{ success: false, message: "Validation error", errors: [{ path, msg, ... }] }
401Tanpa token / token tidak valid atau kedaluwarsa / password salahUnauthenticated. · Invalid token · Invalid password
404Login dengan e-mail yang tidak terdaftarUser not found
500Error database (mis. mengubah atau menghapus id yang tidak ada)Internal server error

Contoh

curl -X POST http://localhost:3000/api/login \
  -H "Content-Type: application/json" \
  -d '{"email": "admin@demo.com", "password": "password"}'

# use the token from the response
curl http://localhost:3000/api/admin/users -H "Authorization: <token>"

Model data & validasi

FieldTipeAturan
idInt, auto incrementPrimary key
nameVarChar(255)Wajib
emailVarChar(255), uniqueWajib, format valid, belum dipakai user lain
passwordVarChar(255)Minimal 6 karakter, disimpan sebagai hash bcrypt
createdAt · updatedAtDateTimeDiisi otomatis

Halaman frontend

RouteHalamanAkses
/HomePublik
/registerRegisterTamu (yang sudah login diarahkan ke dashboard)
/loginLoginTamu
/admin/dashboardDashboardSudah login
/admin/usersDaftar userSudah login
/admin/users/createTambah userSudah login
/admin/users/edit/:idUbah userSudah login

AuthContext menyelaraskan isAuthenticated dengan cookie token; tombol Logout di sidebar menghapus cookie dan kembali ke halaman login.

Demo live

GitHub Pages hanya bisa menyajikan file statis, sehingga server Express dan MySQL tidak bisa berjalan di sana. Karena itu build demo mengganti adapter jaringan axios dengan services/mockApi.js.

Menjalankan di lokal

  1. Buat database MySQL bernama db_express.
  2. Salin backend-express/.env.example menjadi .env lalu isi DATABASE_URL dan JWT_SECRET.
  3. Jalankan API (port 3000):
cd backend-express
npm install
npx prisma migrate dev
node index.js
  1. Jalankan aplikasi React (Vite dev server):
cd frontend-react
npm install
npm run dev

Untuk mencoba mode demo di lokal: VITE_DEMO=true npm run dev.

FundamentalES6

Script Node.js singkat untuk berlatih fitur JavaScript yang dipakai di seluruh project:

let · const · var

variable, variable2, variable3

Arrow function

ArrowFunction1 – 5

Template literal

TemplateStringLiteral

Destructuring

Destructuring, Destructuring2, Restructuring

Spread · Rest

SpreadOperator 1–2, RestParameter 1–2

Parameter default

DefaultParam, DefaultParam2

Array.map

ArrayMap

Promise · async/await

Promise, Promise2, AsyncAwait

Hello World

HelloWorld

Keterbatasan & perbaikan

Sudah diperbaiki

Ide langkah berikutnya

Sembunyikan hash password

Register, create, dan update mengembalikan user lengkap termasuk hash password — pilih hanya id, nama, dan e-mail.

Penyimpanan token lebih aman

Gunakan cookie HttpOnly yang di-set server dan skema standar Bearer.

Tangani token kedaluwarsa

Logout otomatis saat API menjawab 401.

Password opsional saat ubah

Izinkan mengubah nama atau e-mail tanpa mengisi ulang password.

404 untuk id yang tidak ada

Kembalikan 404, bukan 500, saat id user tidak ada.

Deploy backend

Host API dan database MySQL terkelola agar demo bisa memakai backend sungguhan.