# PharmaPlus

[PharmaPlus website](https://shop.pharmaplus.co.ke/)

## Overview

PharmaPlus is Kenya's leading online pharmaceutical e-commerce platform, serving customers across **90+ branches** nationwide. The platform features a catalog of **12,000+ products** spanning categories like Medicine, Vitamins & Supplements, Skin Care, Health Devices, Beauty & Cosmetics, and more — processing over **10,000 transactions daily** with integrated M-Pesa and credit card payment gateways.

## Key Contributions

- Architected and deployed a responsive, interactive **Progressive Web App (PWA)** using React.js and Next.js, ensuring seamless cross-browser and mobile experiences with offline capabilities and lightning-fast live search across the full product catalog
- Engineered and scaled a **secure payment and logistics platform** using Spring Boot and Python/FastAPI, integrating M-Pesa and credit card gateways to orchestrate delivery events and handle high transaction volumes
- Optimized nationwide delivery logistics by integrating **Google Maps Geolocation API** to dynamically calculate optimal routes and service zones across 90+ branches, **reducing average delivery time by 18%**
- Implemented **Google Analytics and custom event tracking** using meta tags and scripts to monitor user behavior, conversion funnels, and application performance, enabling data-driven product improvements
- Designed and implemented a suite of **RESTful APIs** to enable real-time data flow between front-end and back-end systems, directly improving user interaction speed and system responsiveness
- Established a robust **DevOps pipeline** by containerizing microservices with Docker, optimizing application performance, and automating CI/CD workflows to enhance deployment frequency and reliability

## Features

- Live search across 12,000+ pharmaceutical products
- Category browsing (Medicine, Supplements, Skin Care, Health Devices, and more)
- M-Pesa and credit card payment integration
- Nationwide delivery with optimized route calculation
- Prescription upload and processing
- User accounts with wishlist, order history, and product comparison
- Newsletter subscriptions and promotional offers
- Offline-capable Progressive Web App (PWA)

## Tech Stack & Mobile Experience

<div style="display: flex; gap: 2rem; align-items: flex-start; flex-wrap: wrap;">
<div style="flex: 1; min-width: 280px;">

- **Frontend:** React.js / Next.js (PWA)
- **Backend:** Spring Boot (Java), Python / FastAPI
- **DevOps:** Docker, CI/CD Pipelines
- **APIs:** Google Maps Geolocation API, RESTful APIs
- **Analytics:** Google Analytics, Custom Event Tracking
- **Payments:** M-Pesa, Credit Card Gateways
- **Database:** PostgreSQL

</div>
<div style="flex: 0 0 auto; max-width: 260px;">

![PharmaPlus Mobile View](/images/pharmaplus.png)

</div>
</div>

---

_Notes_:


Kenya's leading online pharmaceutical e-commerce platform with 12,000+ products across 90+ branches, processing 10,000+ daily transactions

PharmaPlus

# Digital Marketplace Platform

[GitHub](https://github.com/victorpreston/digital-marketplace-platform)

## Overview

A full-featured digital marketplace platform that enables users to buy and sell products seamlessly. Built with modern microservices architecture, the platform leverages **Spring Boot** for backend services, **Angular** for the frontend, and integrates with multiple **AWS services** to ensure scalability, reliability, and security.
## Key Features

- **Multi-Role Authentication** — Customer, Seller, and Courier roles with Amazon Cognito
- **Product Management** — Complete CRUD operations with S3 image storage and pre-signed URLs
- **Order Processing** — End-to-end order management with status tracking (placed → dispatched → delivered)
- **Delivery Contracts** — Dynamic courier assignment and contract management between sellers and couriers
- **Review System** — Product and courier ratings (1–5) with reviews
- **Advanced Search** — Filter products by category, price range, and text search with pagination
- **Secure** — JWT-based authentication with role-based access control (RBAC)
- **Scalable** — Microservices deployed on AWS EKS with auto-scaling across multiple availability zones

## Microservices Architecture

![Microservices](/images/digital-marketplace-microservices.png)

The platform consists of three Spring Boot microservices deployed on AWS EKS:

- **User Service** — Authentication, registration, and profile management (Customer, Seller, Courier)
- **Product Service** — Product CRUD, image uploads via S3 pre-signed URLs, search and filtering
- **Order Service** — Order lifecycle management, contract handling, and review system

Services communicate over the Kubernetes internal network using DNS service names, with an **Ingress controller** routing external traffic via path-based mapping.

## Infrastructure & DevOps

- **Compute**: AWS EKS with multi-AZ deployment across 2 availability zones, 2 worker nodes per AZ
- **Database**: Amazon DynamoDB with Global Secondary Indexes for optimized queries
- **Storage**: Amazon S3 for product images and static web hosting for the Angular frontend
- **Auth**: Amazon Cognito for user authentication and JWT token management
- **CI/CD**: Jenkins pipeline (Source → Maven → Docker → ECR → EKS) for backend; AWS CodePipeline (Source → CodeBuild → S3 → CodeDeploy) for frontend
- **Networking**: VPC with public/private subnets, NAT Gateways, Internet Gateway, security groups
- **Monitoring**: Amazon CloudWatch for logging and metrics
- **IaC**: AWS CloudFormation for infrastructure provisioning

## Design Patterns

- **Repository Pattern** — Data access abstraction for DynamoDB operations
- **Builder Pattern** — AWS SDK client construction
- **Chain of Responsibility** — Security filter chains for authentication
- **DTO Pattern** — Clean data transfer between layers
- **Adapter Pattern** — JWT authentication integration
- **Facade Pattern** — Simplified DynamoDB operations interface

## Security

- Kubernetes Secrets for credential management
- Amazon Cognito for verified user registration
- IAM policies with least-privilege access
- JWT validation on all authenticated endpoints
- Private subnets for application pods with public Ingress controller
- Encryption at rest (DynamoDB with KMS, S3 with SSE-S3)

## Tech Stack

- Spring Boot 3.2.3 | Java 17 | Maven
- Angular 18 | Angular Material | NgRx
- AWS EKS | DynamoDB | S3 | Cognito | CloudFormation
- Docker | Kubernetes | Jenkins | NGINX
- AWS CodePipeline | CodeBuild | CodeDeploy

---

_A cloud-native e-commerce platform demonstrating production-grade microservices architecture on AWS._


A scalable, cloud-native e-commerce platform built with Spring Boot microservices on AWS EKS, Angular frontend, and DynamoDB

Digital Marketplace

# AgriTrack - AI-Powered Farming Solutions

## Overview

[Website](https://agri-track.vercel.app/)

![diagram-export-3-20-2025-5_55_38-PM](https://github.com/user-attachments/assets/a40c0b97-0ce3-4577-b509-435f52c04d65)

AgriTrack is a Flutter-based mobile application designed to revolutionize farming through AI-powered solutions. The app helps farmers optimize crop production, detect diseases early, make data-driven decisions, and maximize profits through smart technology.

## Key Features

### AI Disease Detection

- Upload photos of crops to instantly identify diseases
- Get detailed treatment recommendations
- Access historical disease data for your farm

### Integrated E-commerce

- Purchase recommended agricultural products directly through the platform
- Compare prices from various suppliers
- Track your orders and delivery status

### Precision Farming

- Real-time weather insights for your specific location
- Resource usage optimization recommendations (water, fertilizer, etc.)
- Season planning based on climate predictions

### Market Predictions

- Access real-time market prices for your crops
- Trend analysis and future price predictions
- Optimal harvest timing recommendations

### Farmer Dashboard

- Comprehensive overview of farm performance
- Task management system
- Resource usage analytics
- Yield tracking and forecasting

## Tech Stack

- **Frontend**: Flutter (Dart)
- **State Management**: Provider/Bloc
- **Backend**: Supabase
- **Authentication**: Custom auth with third-party options (Google, Facebook)
- **AI Integration**: TensorFlow Lite for on-device image processing
- **Maps & Location**: Google Maps API
- **Storage**: Supabase Storage
- **Analytics**: Firebase Analytics

## Project Structure

```
agritrack/
├── lib/
│   ├── config/                  # App configuration, constants, theme
│   ├── core/                    # Core functionality, utilities, helpers
│   ├── data/                    # Data layer (repositories, models, services)
│   │   ├── models/              # Data models
│   │   ├── repositories/        # Data repositories
│   │   └── services/            # API services
│   ├── domain/                  # Business logic
│   │   ├── entities/            # Business entities
│   │   └── usecases/            # Business use cases
│   ├── presentation/            # UI layer
│   │   ├── common/              # Common widgets, dialogs
│   │   ├── screens/             # App screens
│   │   │   ├── auth/            # Authentication screens
│   │   │   ├── dashboard/       # Dashboard screens
│   │   │   ├── disease/         # Disease detection screens
│   │   │   ├── ecommerce/       # E-commerce screens
│   │   │   ├── market/          # Market prediction screens
│   │   │   └── profile/         # User profile screens
│   │   ├── widgets/             # Reusable widgets
│   │   └── bloc/                # State management
│   ├── routes.dart              # App routes
│   └── main.dart                # Entry point
├── assets/                      # Assets (images, fonts, etc.)
├── test/                        # Tests
└── pubspec.yaml                 # Dependencies
```

## Getting Started

### Prerequisites

- Flutter SDK (2.10.0 or higher)
- Dart SDK (2.16.0 or higher)
- Android Studio / VS Code
- An active Supabase account
- Google Maps API key (for location features)

### Installation

1. Clone the repository:

   ```bash
   git clone https://github.com/victorpreston/agritrack-app.git
   cd agritrack
   ```

2. Install dependencies:

   ```bash
   flutter pub get
   ```

3. Create a `.env` file in the root directory with your API keys:

   ```
   SUPABASE_URL=your_supabase_url
   SUPABASE_ANON_KEY=your_supabase_anon_key
   GOOGLE_MAPS_API_KEY=your_google_maps_api_key
   ```

4. Run the app:
   ```bash
   flutter run
   ```

## Development Guidelines

### Code Style

We follow the official [Dart style guide](https://dart.dev/guides/language/effective-dart/style). Please ensure your code follows these conventions before submitting PRs.

### Architecture

AgriTrack follows a clean architecture approach with the following layers:

- **Presentation Layer**: UI components, screens, widgets
- **Domain Layer**: Business logic, use cases
- **Data Layer**: Data sources, repositories, models

### State Management

We use the BLoC pattern for state management. Please follow these guidelines:

- Create separate BLoCs for different features
- Keep BLoC logic simple and focused
- Use events for user interactions
- Use states to represent UI states

### Committing Code

- Follow conventional commit messages
- Keep commits small and focused
- Write descriptive PR descriptions

## Testing

- Unit tests: `flutter test`
- Integration tests: `flutter test integration_test`
- Widget tests: included in the main test suite

## UI/UX Guidelines

The app follows a professional, future-oriented design language with:

- Clean, minimalist interfaces
- High contrast for outdoor visibility
- Intuitive navigation
- Responsive layouts for different screen sizes
- Accessibility considerations

## Backend Setup (Supabase)

1. Create a new Supabase project
2. Set up the following tables:

   - users
   - farms
   - crops
   - disease_detections
   - market_prices
   - orders
   - products

3. Configure authentication with both email/password and third-party providers

## Deployment

### Android

1. Generate keystore: `keytool -genkey -v -keystore agritrack.keystore -alias agritrack -keyalg RSA -keysize 2048 -validity 10000`
2. Build APK: `flutter build apk --release`
3. Build App Bundle: `flutter build appbundle --release`

### iOS

1. Set up certificates in Apple Developer account
2. Build IPA: `flutter build ipa --release`

## Contributing

1. Fork the repository
2. Create feature branch: `git checkout -b feature/amazing-feature`
3. Commit changes: `git commit -m 'Add amazing feature'`
4. Push to branch: `git push origin feature/amazing-feature`
5. Open a Pull Request

## Acknowledgements

- Flutter Team
- Supabase
- TensorFlow


AgriTrack is a Flutter-based mobile application designed to revolutionize farming through AI-powered solutions.

AgriTrack

# Buzlin

[Play Store](https://play.google.com/store/apps/details?id=ca.buzlin.ca&hl=en) | [App Store](https://apps.apple.com/th/app/buzlin/id6636532736)

## Overview

Buzlin is a feature-rich **service marketplace** mobile application built with Flutter, connecting users with local service providers across multiple categories. Available on both the **Google Play Store and Apple App Store**, Buzlin enables seamless discovery, booking, and payment for services — supporting **PayU, PayPal, and Stripe** payment gateways for secure, flexible transactions.

## Key Contributions

- Architected and developed a cross-platform mobile application using **Flutter and Dart**, delivering a smooth, native-like experience on both Android and iOS
- Built a scalable **Java-based backend** with RESTful APIs to handle service listings, user authentication, bookings, and real-time notifications
- Integrated **multiple payment gateways** (PayU, PayPal, Stripe) enabling users to pay securely through their preferred method
- Implemented **in-app messaging** for real-time communication between service providers and customers
- Designed an intuitive **search and discovery** system with category filtering, location-based results, and service provider ratings
- Developed a **provider dashboard** for service professionals to manage listings, track bookings, and monitor earnings

## Features

- Browse and discover services across multiple categories
- Book and schedule service appointments
- Secure payments via PayU, PayPal, and Stripe
- In-app messaging between users and providers
- Service provider profiles with ratings and reviews
- Location-based service discovery
- Push notifications for booking updates
- Provider dashboard for managing listings and earnings

## Tech

- Flutter (Dart) — Cross-platform mobile
- Java — Backend services
- PayU, PayPal, Stripe — Payment gateways
- Firebase — Push notifications & analytics
- REST APIs — Service communication

## Screenshots

![Buzlin screenshot](https://i.postimg.cc/0jXPPKht/Screenshot-2025-11-19-113250.png)

---

_Notes_:


A service marketplace app with 10+ downloads, connecting users with local providers via PayU, PayPal, and Stripe payments

Buzlin

# Buzryde

[Play Store](https://play.google.com/store/apps/details?id=com.buzryde.com&hl=en) | [App Store](https://apps.apple.com/th/app/buzryde-book-rides-easily/id6739767230)

## Overview

Buzryde is a modern **ride-hailing mobile application** built with Flutter, available on both the **Google Play Store and Apple App Store** with **50+ downloads**. The platform connects riders with drivers seamlessly, offering real-time GPS tracking, fare estimation, and secure payments through **PayU, PayPal, and Stripe** gateways.

## Key Contributions

- Developed a cross-platform ride-hailing app using **Flutter and Dart**, delivering a smooth native experience on both Android and iOS
- Built a scalable **Java-based backend** with RESTful APIs to manage ride requests, driver matching, fare calculation, and real-time tracking
- Integrated **multiple payment gateways** (PayU, PayPal, Stripe) for seamless and secure ride payments
- Implemented **real-time GPS tracking** with live driver location updates and dynamic route visualization on interactive maps
- Designed an intelligent **driver matching algorithm** that pairs riders with the nearest available drivers for minimal wait times
- Built a **driver dashboard** for managing ride requests, tracking earnings, and viewing trip history

## Features

- Book rides with real-time driver tracking on interactive maps
- Fare estimation before booking confirmation
- Secure payments via PayU, PayPal, and Stripe
- Ride history and digital receipts
- Driver ratings and reviews
- Push notifications for ride updates and promotions
- Driver mode with earnings dashboard
- Multiple vehicle categories and ride options

## Tech

- Flutter (Dart) — Cross-platform mobile
- Java — Backend services
- PayU, PayPal, Stripe — Payment gateways
- Google Maps API — Real-time tracking & routing
- Firebase — Push notifications & analytics
- REST APIs — Service communication

## Screenshots

![Buzryde screenshot](https://i.postimg.cc/ncstqz62/Screenshot-2025-11-19-113417.png)

---

_Notes_:


A ride-hailing app with 50+ downloads, offering real-time GPS tracking and secure payments via PayU, PayPal, and Stripe

Buzryde

Notely is an open-source note-taking application designed to provide users with a seamless and efficient platform for managing their notes. Built with modern web technologies, Notely ensures a responsive and user-friendly experience across various devices.

## Features

- **User Authentication**: Secure user registration and login functionalities to protect your notes.
- **Rich Text Editing**: Create and format notes with a user-friendly rich text editor.
- **Tagging System**: Organize notes using tags for easy categorization and retrieval.
- **Search Functionality**: Quickly search through notes to find specific information.
- **Responsive Design**: Optimized for desktops, tablets, and mobile devices.

## Technologies Used

- ![Next.js](https://img.shields.io/badge/Next.js-000000?style=for-the-badge&logo=next.js&logoColor=white) **Next.js 14**: A React framework for server-rendered applications.
- ![Kinde](https://img.shields.io/badge/Kinde-000000?style=for-the-badge&logoColor=white) **Kinde**: Authentication and user management platform.
- ![Prisma](https://img.shields.io/badge/Prisma-2D3748?style=for-the-badge&logo=prisma&logoColor=white) **Prisma**: Next-generation ORM for database interactions.
- ![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=for-the-badge&logo=supabase&logoColor=white) **Supabase**: Open-source Firebase alternative for real-time databases.
- ![Shadcn UI](https://img.shields.io/badge/Shadcn_UI-000000?style=for-the-badge&logoColor=white) **Shadcn UI**: Component library for building user interfaces.
- ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white) **Tailwind CSS**: Utility-first CSS framework for rapid UI development.

## Getting Started

### Prerequisites

- ![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white) **Node.js**: Ensure Node.js is installed on your machine.
- ![Supabase](https://img.shields.io/badge/Supabase-3ECF8E?style=for-the-badge&logo=supabase&logoColor=white) **Supabase Account**: Set up a Supabase account for database services.
- ![Kinde](https://img.shields.io/badge/Kinde-000000?style=for-the-badge&logoColor=white) **Kinde Account**: Set up a Kinde account for authentication services.

### Installation

1. **Clone the Repository**:

   ```
   git clone https://github.com/victorpreston/Notely.git

   ```

2. Navigate to the Project Directory:

   ```
   cd Notely

   ```

3. Install Dependencies:

   ```
   npm install

   ```

4. Set Up Environment Variables:

Create a `.env` file in the root directory with the following content:

    ```
    NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
    KINDER_CLIENT_ID=your_kinde_client_id
    KINDER_CLIENT_SECRET=your_kinde_client_secret

Run the Development Server:

    ```
    npm run dev

The application will be available at http://localhost:3000.

Folder Structure
The project's folder structure is organized as follows:

    ```
    Notely/
    ├── app/
    │   ├── components/
    │   ├── pages/
    │   └── styles/
    ├── lib/
    ├── prisma/
    ├── public/
    ├── .eslintrc.json
    ├── .gitignore
    ├── README.md
    ├── next.config.mjs
    ├── package.json
    ├── postcss.config.js
    ├── tailwind.config.ts
    └── tsconfig.json
    app/: Contains the main application components, pages, and styles.
    lib/: Utility functions and libraries.
    prisma/: Prisma schema and migrations.
    public/: Static assets like images and fonts.

### Configuration Files: ESLint, Tailwind CSS, TypeScript, and Next.js configurations.


Notely is an open-source note-taking application designed to provide users with a platform for managing their notes

Notely

Free Unlimited File Converter
Unleash your creativity with Convertall – the ultimate online tool for unlimited and free multimedia conversion. Transform images, audio, and videos effortlessly, without restrictions. Start converting now and elevate your content like never before!

Features

- Image Conversion
- Audio Transformation
- Video Metamorphosis
- User-Friendly Interface

Tech Stack

- Next.js
- TypeScript
- TailwindCSS
- Shadcn + NextUI
- ffmpeg
- webassembly

Follow these steps to set up the project locally on your machine.

**Prerequisites**

Make sure you have the following installed on your machine:

- [Git](https://git-scm.com/)
- [Node.js](https://nodejs.org/en)
- [npm](https://www.npmjs.com/) (Node Package Manager)

**Cloning the Repository**

```
  git clone https://github.com/victorpreston/convertall.git
  cd convertall
```

**Installation**

Install the project dependencies using npm:

```
  npm install
```

Replace the placeholder values with your actual credentials

**Running the Project**

```
  npm start
```

Open [http://localhost:3000](http://localhost:3000) in your browser to view the project.


The ultimate multimedia conversion tool for transforming images, audio files, and videos.

Convert All

# Test Coding Elemes.id

a front-end test application for a food delivery service named "Elemes." It showcases various food categories and trending recipes, providing users with options like cupcakes, pizzas, kebabs, salmon, and doughnuts. The site includes sections such as Home, About, Promotions, Blogs, and Contact Us, aiming to offer a comprehensive user experience.

![alt](https://i.postimg.cc/gcyW7XHc/cover.png)

## Installation

```bash
# Clone Repo
git clone https://github.com/victorpreston/elemes-vue-test.git
```

```bash
# npm
npm install

# pnpm
pnpm install

# bun
bun install
```

## Running Project

```bash
# npm
npm run dev

# pnpm
pnpm dev

# bun
bun run dev
```


This ultimate website for food ordering and delivery services

Elemes Test

# Plana

Plana is a full-stack event management application designed to streamline the organization and coordination of events. It offers a robust backend API and a dynamic frontend interface, providing users with an efficient platform to manage events seamlessly.

## Features

- **Event Creation and Management**: Easily create, update, and delete events with detailed information.
- **User Authentication**: Secure user registration and login functionalities.
- **Responsive Design**: Optimized for various devices, ensuring a consistent user experience.
- **Image Uploads**: Integrates with Cloudinary for efficient image storage and retrieval.

## Technologies Used

### Backend

- ![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white) **Node.js**: JavaScript runtime for building scalable network applications.
- ![Express.js](https://img.shields.io/badge/Express.js-000000?style=for-the-badge&logo=express&logoColor=white) **Express.js**: Minimalist web framework for Node.js.
- ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white) **TypeScript**: Typed superset of JavaScript that compiles to plain JavaScript.
- ![Prisma](https://img.shields.io/badge/Prisma-2D3748?style=for-the-badge&logo=prisma&logoColor=white) **Prisma ORM**: Next-generation ORM for Node.js and TypeScript.
- ![PostgreSQL](https://img.shields.io/badge/PostgreSQL-336791?style=for-the-badge&logo=postgresql&logoColor=white) **PostgreSQL**: Open-source object-relational database system.

### Frontend

- ![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white) **Angular 18**: Platform for building dynamic web applications.
- ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white) **Tailwind CSS**: Utility-first CSS framework for rapid UI development.

## Folder Structure

Here's an overview of the folder structure to help you understand the project organization:

```
plana/
├── backend/
│   ├── prisma/
│   ├── src/
│   │   ├── controllers/
│   │   ├── middlewares/
│   │   ├── models/
│   │   ├── routes/
│   │   ├── services/
│   │   ├── utils/
│   │   └── index.ts
│   └── package.json
│
├── frontend/
│   ├── src/
│   │   ├── app/
│   │   ├── assets/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── services/
│   │   └── main.ts
│   └── package.json
│
└── README.md
```

## Getting Started

### Prerequisites

- ![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white) **Node.js**: Ensure Node.js is installed on your machine.
- ![PostgreSQL](https://img.shields.io/badge/PostgreSQL-336791?style=for-the-badge&logo=postgresql&logoColor=white) **PostgreSQL**: Set up a PostgreSQL database.

### Installation

1. **Clone the Repository**:

   ```
   git clone https://github.com/victorpreston/plana.git
   ```

2. **Navigate to the Project Directory**:

   ```
   cd plana
   ```

3. **Install Backend Dependencies**:

   ```
   cd backend
   npm install
   ```

4. **Set Up Environment Variables**:
   Create a `.env` file in the `backend` directory with the following:

   ```env
   DATABASE_URL=your_postgresql_database_url
   CLOUDINARY_URL=your_cloudinary_url
   ```

5. **Run Database Migrations**:

   ```
   npx prisma migrate dev
   ```

6. **Start the Backend Server**:

   ```
   npm run dev
   ```

7. **Install Frontend Dependencies**:

   ```
   cd ../frontend
   npm install
   ```

8. **Start the Frontend Server**:
   ```
   npm start
   ```

## Usage

Once both servers are running, you can access the application at `http://localhost:4200`. Register or log in to manage and explore events.

## Contributing

Contributions are welcome! Fork the repository and submit a pull request with your changes.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.


A full-stack event management application designed to streamline the organization and coordination of events.

Plana

# ForJobSeekers

ForJobSeeker is a comprehensive job search and application platform that helps job seekers find remote job opportunities, create and update their profiles, and track their applications. This platform streamlines the job-seeking process and provides an intuitive user experience for individuals looking for remote job opportunities.

## Features

- **Job Listings**: Browse and search for remote job opportunities.
- **Profile Management**: Create and update job seeker profiles, including personal details, skills, experience, and more.
- **Job Applications**: Apply for jobs and track the status of applications.
- **User Authentication**: Secure user registration and login.
- **Responsive Design**: Optimized for mobile, tablet, and desktop devices.

## Technologies Used

### Backend

- ![Node.js](https://img.shields.io/badge/Node.js-339933?style=for-the-badge&logo=node.js&logoColor=white) **Node.js**: JavaScript runtime for building scalable network applications.
- ![Express.js](https://img.shields.io/badge/Express.js-000000?style=for-the-badge&logo=express&logoColor=white) **Express.js**: Fast, minimalist web framework for Node.js.
- ![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white) **TypeScript**: Typed superset of JavaScript that compiles to plain JavaScript.
- ![Prisma](https://img.shields.io/badge/Prisma-2D3748?style=for-the-badge&logo=prisma&logoColor=white) **Prisma**: Modern ORM for TypeScript and Node.js.

### Frontend

- ![Angular](https://img.shields.io/badge/Angular-DD0031?style=for-the-badge&logo=angular&logoColor=white) **Angular 18**: Framework for building client-side applications.
- ![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-38B2AC?style=for-the-badge&logo=tailwind-css&logoColor=white) **Tailwind CSS**: Utility-first CSS framework for rapid UI development.

## Folder Structure

The folder structure of the ForJobSeeker project is as follows:

    forjobseeker/
    ├── backend/
    │   ├── src/
    │   │   ├── controllers/    # Controllers for handling requests
    │   │   ├── middlewares/    # Middleware functions
    │   │   ├── models/         # Prisma models
    │   │   ├── routes/         # Route definitions
    │   │   ├── services/       # Business logic services
    │   │   ├── utils/          # Utility functions
    │   │   └── index.ts        # Main entry point for the backend server
    │   ├── prisma/             # Prisma schema and migrations
    │   └── package.json        # Backend dependencies and scripts
    │
    ├── frontend/
    │   ├── src/
    │   │   ├── app/            # Main Angular application module
    │   │   ├── components/     # Reusable UI components
    │   │   ├── pages/          # Page-level components
    │   │   ├── services/       # Services for API calls and state management
    │   │   └── main.ts         # Main entry point for the Angular application
    │   └── package.json        # Frontend dependencies and scripts
    │
    ├── .gitignore              # Git ignore file
    ├── README.md               # Project documentation
    └── LICENSE                 # License for the project

## Getting Started

Clone the Repository:

    git clone https://github.com/victorpreston/forjobseeker.git

Navigate to the Project Directory:

    cd forjobseeker

Install Backend Dependencies:

    cd backend
    npm install

Set Up Environment Variables:

Create a `.env` file in the backend directory with the following content:

Run the Backend Server:

    npm run dev

Navigate to the Frontend Directory:

    cd ../frontend

Install Frontend Dependencies:

    npm install

Start the Frontend Server:

    npm start

### Usage

Once both the backend and frontend servers are running, access the application at http://localhost:4200 to browse job listings, manage your profile, and apply for jobs.

### Contributing

Contributions are welcome! Please follow these steps if you'd like to contribute to the ForJobSeeker project:

1. Fork the repository.
2. Create a new branch `(git checkout -b feature-branch).`
3. Make your changes and commit them `(git commit -m 'Add new feature')`.
4. Push to the branch `(git push origin feature-branch)`.
5. Open a pull request.


A comprehensive job search and application platform that helps job seekers find remote job opportunities.

Victor Preston

Projects

Loading...