KitaJobs
Full-stack job board and community platform for the Philippine tech ecosystem.
Table of contents
- What it does
- Why it's useful
- Tech stack
- Getting started
- Development workflow
- Project structure & important files
- Where to get help
- Maintainers & contributing
What it does
KitaJobs is a LinkedIn-style platform where employers, freelancers and job seekers can create profiles, post and browse job listings, and manage applications. The project includes:
- A React + Vite frontend (TypeScript)
- A Node.js + Express backend (TypeScript) with JWT authentication
- MongoDB for data persistence
API base path: /api (see backend/src/server.ts).
Why it's useful
- Focused job marketplace for tech roles.
- Ready-to-run full-stack starter: auth, user profiles, job CRUD, and client UI.
- Modern stack (Vite, React, Tailwind, Zustand) that is easy to extend.
Tech stack
- Frontend: React, Vite, TypeScript, Tailwind CSS, Zustand, Framer Motion
- Backend: Node.js, Express, TypeScript, Mongoose, JWT
- Database: MongoDB (Atlas or local)
Getting started
Prerequisites
- Node.js (v18+ recommended)
- npm (or yarn/pnpm)
- MongoDB (Atlas URI or local instance)
Quick start (development)
- Clone the repository
git clone <your-repo-url>
cd kita-jobs-app
- Backend setup
cd backend
npm install
# create a .env file with the following variables (example):
# MONGODB_URI=your-mongodb-connection-string
# JWT_SECRET=your-secret-key
# PORT=8000
npm run dev