IskedyulKo is a full-stack appointment booking web application designed specifically for small Filipino businesses. It provides an easy-to-use platform for business owners to manage their services and appointments while offering customers a seamless booking experience.
- Dashboard Overview - View today's appointments and key metrics
- Appointment Management - Confirm, cancel, or mark appointments as complete
- Service Management - Add, edit, and delete services with pricing
- Business Settings - Configure working hours and business information
- Shareable Booking Link - Custom URL for customers to book appointments
- Easy Booking Process - 4-step booking: Service → Date → Time → Details
- Appointment Tracking - Track booking status using unique booking code
- No Registration Required - Book appointments without creating accounts
- Mobile Friendly - Responsive design for all devices
Frontend:
- React 18 + TypeScript
- TailwindCSS + Vite
- React Router DOM
Backend:
- Express.js + Node.js
- MySQL Database
- JWT Authentication
Tools:
- ESLint + PostCSS
- Nodemon for development
-
Clone the repository
git clone <repository-url> cd iskedyulko
-
Install dependencies
# Server cd server && npm install # Client cd ../client && npm install
-
Set up environment variables
cp .env.example .env # Edit .env with your database credentials -
Set up database
cd server && npm run setup-db
-
Start development servers
# Terminal 1 - Server cd server && npm run dev # Terminal 2 - Client cd client && npm run dev
-
Access the application
- Frontend: http://localhost:5173
- Backend: http://localhost:5000
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.
