🚀 Suilor - Guiding Your Career Journey

A secure, transparent, and decentralized job board and recruitment platform on the Sui blockchain

Guiding Your Career Journey

📋 Table of Contents

Features
Technology Stack
Installation
Usage
Smart Contract
Testing
Deployment
Project Structure
Contributors
Contributing

✨ Features

Core Features

✅ Job Posting: Employers can create job listings on the blockchain
✅ Application System: Candidates can apply for jobs directly on-chain
✅ Hiring Process: Employers can review applications and hire candidates
✅ User Profiles: Users can create public/private profiles with customizable information
✅ Username System: Unique username registration linked to wallet addresses
✅ Capability-based Access Control: Secure authorization system
✅ On-chain Events: Event emission for all important transactions
✅ Multi-language Support: English, Turkish, German, and Greek languages

Bonus Features 🏅

Move Smart Contract

✅ Vectors: Vector usage for job and application collections
✅ Option: Option type for optional salary and hired candidate
✅ Shared Objects: Global JobBoard shared object
✅ Events: JobPosted, ApplicationSubmitted, CandidateHired, ProfileCreated events
✅ Access Control: EmployerCap capability pattern
✅ Dynamic Fields: Applications stored as dynamic fields
✅ Display Object: Display standard for Job objects
✅ Contract Upgradeability: Upgrade support with version control
✅ Clock: Sui Clock object usage for timestamps
✅ Random: Random object for featured job selection

Frontend & Integrations

✅ Sui TypeScript SDK: Latest SDK usage
✅ Wallet Integration: Wallet connection with @mysten/dapp-kit
✅ ZkLogin: Blockchain authentication with Google/Facebook (ready)
✅ Walrus Storage: CV and document storage on Walrus
✅ Modern UI/UX: Animated interface with Tailwind CSS and Framer Motion
✅ Sui Brand Colors: Official Sui color palette usage
✅ Responsive Design: Perfect display on all devices
✅ i18n Support: Full internationalization with 4 languages

Technological Highlights

Walrus Integration: CVs and documents stored on decentralized Walrus storage
ZkLogin Ready: Social media authentication infrastructure for blockchain
Real-time Updates: Automatic updates every 10 seconds with React Query
Animated UI: Professional animations with Framer Motion
Type-Safe: End-to-end TypeScript usage
Comprehensive Testing: Move tests + Jest integration tests
Legal Compliance: KVKK & GDPR compliant privacy pages

🛠 Technology Stack

Blockchain

Sui Move: Smart contract development
Sui Framework: Latest mainnet framework
Dynamic Fields: Scalable data structures

Frontend

React 18: Modern React with hooks
TypeScript 5: Type-safe development
Vite: Lightning fast build tool
Tailwind CSS: Utility-first CSS
Framer Motion: Advanced animations
Radix UI: Accessible component primitives
i18next: Internationalization framework

Sui Ecosystem

@mysten/dapp-kit: Wallet and Sui integration
@mysten/sui: Sui TypeScript SDK
@mysten/zklogin: ZkLogin authentication
Walrus: Decentralized storage

Testing & DevOps

Jest: Unit and integration tests
Sui Move Test: Smart contract tests
Docker: Containerization
Nginx: Production web server

📦 Installation

Requirements

Node.js 20+
Sui CLI
Docker (optional)
Git

Step 1: Clone the Repository

git clone <repo-url>
cd job-board2

Step 2: Run Setup Script

chmod +x scripts/setup.sh
./scripts/setup.sh

This script:

Installs frontend dependencies
Creates .env file
Creates necessary directories

Step 3: Deploy Smart Contract

chmod +x scripts/deploy.sh
./scripts/deploy.sh

This script:

Builds the Move package
Runs Move tests
Deploys to testnet
Displays Package ID

Step 4: Environment Variables

Update frontend/.env file with deployment output:

VITE_NETWORK=testnet
VITE_PACKAGE_ID=<your-package-id>
VITE_JOB_BOARD_ID=<your-job-board-id>
VITE_WALRUS_PUBLISHER_URL=https://publisher.walrus-testnet.walrus.space
VITE_WALRUS_AGGREGATOR_URL=https://aggregator.walrus-testnet.walrus.space

🚀 Usage

Development Mode

cd frontend
npm run dev

The application will run at http://localhost:3000.

Production Build

cd frontend
npm run build
npm run preview

Run with Docker

docker-compose up -d

The application will run at http://localhost:3000.

🔧 Smart Contract

Core Functions

Creating Job Listing

public fun post_job(
    board: &mut JobBoard,
    title: vector<u8>,
    company: vector<u8>,
    location: vector<u8>,
    description: vector<u8>,
    salary_amount: u64,
    include_salary: bool,
    clock: &Clock,
    ctx: &mut TxContext,
)

Applying to Job

public fun apply_to_job(
    board: &mut JobBoard,
    job: &mut Job,
    cover_message: vector<u8>,
    resume_url: vector<u8>,
    clock: &Clock,
    ctx: &mut TxContext,
)

Hiring Candidate

public fun hire_candidate(
    job: &mut Job,
    _employer_cap: &EmployerCap,
    application_index: u64,
    clock: &Clock,
    ctx: &mut TxContext,
)

Creating User Profile

public fun create_profile(
    board: &mut JobBoard,
    username: vector<u8>,
    full_name: vector<u8>,
    bio: vector<u8>,
    location: vector<u8>,
    clock: &Clock,
    ctx: &mut TxContext,
)

Data Structures

// Global shared object
public struct JobBoard has key {
    id: UID,
    version: u64,
    total_jobs: u64,
    total_applications: u64,
    active_jobs: vector<ID>,
}

// Job listing
public struct Job has key, store {
    id: UID,
    title: String,
    company: String,
    location: String,
    description: String,
    salary: Option<u64>, // Option<T> usage
    employer: address,
    status: JobStatus,
    created_at: u64,
    application_count: u64,
    hired_candidate: Option<address>, // Option<T> usage
}

// User profile
public struct UserProfile has key, store {
    id: UID,
    owner: address,
    username: String,
    full_name: String,
    bio: String,
    skills: vector<String>,
    experience: String,
    education: String,
    location: String,
    email: Option<String>,
    portfolio_url: Option<String>,
    resume_url: Option<String>,
    is_public: bool,
    created_at: u64,
    updated_at: u64,
}

// Capability pattern
public struct EmployerCap has key, store {
    id: UID,
    job_id: ID,
}

🧪 Testing

Move Tests

cd move
sui move test

Test coverage:

✅ Job board initialization
✅ Job posting (with/without salary)
✅ Job applications
✅ Multiple applications
✅ Candidate hiring
✅ Job closing
✅ Job updates
✅ User profile creation
✅ Profile updates and visibility
✅ Access control (unauthorized tests)
✅ Job status validations
✅ Username uniqueness

Frontend Tests

cd frontend
npm test

Integration test coverage:

✅ Sui client connection
✅ Transaction creation
✅ Data structure validation
✅ Status transitions
✅ Salary constraints
✅ Address formatting

📊 Deployment

Deploy to Testnet

./scripts/deploy-testnet.sh

This automated script:

Builds the contract
Runs tests
Deploys to testnet
Extracts object IDs
Creates .env.local

See TESTNET_GUIDE.md for detailed deployment instructions.

Deploy to Mainnet

Change network to mainnet in .env file
Run deployment script
Build and deploy frontend

Docker Production

docker-compose up -d --build

📁 Project Structure

job-board2/
├── move/                          # Move smart contracts
│   ├── sources/
│   │   └── job_board.move        # Main contract
│   ├── tests/
│   │   └── job_board_tests.move  # Contract tests
│   └── Move.toml
│
├── frontend/                      # React frontend
│   ├── src/
│   │   ├── components/           # UI components
│   │   │   ├── ui/              # Radix UI components
│   │   │   ├── WalletConnector.tsx
│   │   │   ├── ZkLoginButton.tsx
│   │   │   ├── JobCard.tsx
│   │   │   ├── PostJobModal.tsx
│   │   │   ├── ApplyJobModal.tsx
│   │   │   ├── Header.tsx
│   │   │   ├── Footer.tsx
│   │   │   └── HireCandidateButton.tsx
│   │   ├── hooks/               # Custom hooks
│   │   │   ├── useSuiJobs.ts
│   │   │   ├── useWalrus.ts
│   │   │   └── useProfile.ts
│   │   ├── pages/
│   │   │   ├── HomePage.tsx
│   │   │   ├── JobDetailPage.tsx
│   │   │   ├── ProfilePage.tsx
│   │   │   ├── TermsPage.tsx
│   │   │   ├── PrivacyPage.tsx
│   │   │   └── KvkkGdprPage.tsx
│   │   ├── i18n/                # Internationalization
│   │   │   ├── locales/
│   │   │   │   ├── en.json
│   │   │   │   ├── tr.json
│   │   │   │   ├── de.json
│   │   │   │   └── el.json
│   │   │   └── index.ts
│   │   ├── lib/
│   │   │   └── utils.ts
│   │   ├── config/
│   │   │   ├── constants.ts
│   │   │   └── sui.config.ts
│   │   ├── __tests__/           # Tests
│   │   └── App.tsx
│   ├── package.json
│   └── vite.config.ts
│
├── scripts/                       # Deployment scripts
│   ├── deploy.sh
│   ├── deploy-testnet.sh
│   ├── test-walrus.sh
│   └── setup.sh
│
├── Dockerfile                     # Docker configuration
├── docker-compose.yml
├── nginx.conf
├── TESTNET_GUIDE.md
├── ZKLOGIN_GUIDE.md
├── QUICK_START.md
└── README.md

🎨 UI/UX Features

Sui Brand Colors

Primary: #4DA2FF (Sui Blue)
Secondary: #6FBCF0 (Lighter Sui Blue)
Accent: #00C2FF (Sui Cyan)

Animations

Page transitions: Framer Motion
Card hover effects
Floating elements (Hero section)
Gradient background animation
Smooth scrolling

Responsive Design

Mobile-first approach
Tablet optimization
Desktop wide-screen support

🏆 Challenge Criteria Fulfillment

Technical Design & Move Contracts (30 points)

✅ Vectors usage (active_jobs, applications)
✅ Option usage (salary, hired_candidate, profile fields)
✅ Shared objects (JobBoard)
✅ Events (5 different events)
✅ Access control (EmployerCap pattern)
✅ Dynamic fields (applications, username mapping)
✅ Display Object
✅ Contract upgradeability (version control)
✅ Clock object
✅ Random object

Completeness of Features (25 points)

✅ Wallet connection
✅ Job posting
✅ Job applications
✅ Hiring function
✅ Job listings
✅ Job details
✅ "My Jobs" page
✅ User profiles
✅ Real-time data updates

User Experience (15 points)

✅ Modern and user-friendly interface
✅ Sui brand colors
✅ Smooth animations
✅ Responsive design
✅ Loading states
✅ Error handling
✅ Toast notifications
✅ Multi-language support

Bonus Features & Innovation (20 points)

✅ Walrus integration (CV storage)
✅ ZkLogin ready infrastructure
✅ Dynamic fields usage
✅ Display Object standard
✅ Contract upgradeability
✅ Clock and Random objects
✅ Comprehensive testing
✅ Docker deployment ready
✅ User profiles with privacy controls
✅ Username system

Presentation (10 points)

✅ Detailed README
✅ Code documentation
✅ Deployment scripts
✅ Clear project structure
✅ Multiple guides (Testnet, ZkLogin, Quick Start)

🔐 Security

Capability pattern for access control
Input validation
Transaction replay protection
Version control for upgrade security
Username uniqueness validation
Privacy controls for user profiles

👥 Contributors

This project was developed by:

Aydın Yakar
Ensar Mert Günay
Ulaş Bal

🤝 Contributing

We welcome contributions! Please:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

📝 License

This project is licensed under the MIT License.

🙏 Acknowledgments

Sui Foundation
Move Community
Walrus Team
Bootcamp organizers

📞 Contact

For questions, please open an issue or reach out at hello@suilor.xyz

Note: This project was developed for the Sui Move Bootcamp Challenge and aims to showcase the future of decentralized technologies.

🌟 Demo

Live Demo: suilor.xyz
Testnet Deployment: See TESTNET_GUIDE.md for deployment instructions

Made with ❤️ using Sui Move & React

Suilor - Guiding Your Career Journey

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
frontend		frontend
logo		logo
move		move
scripts		scripts
.dockerignore		.dockerignore
.gitignore		.gitignore
Dockerfile		Dockerfile
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
nginx.conf		nginx.conf
package.json		package.json

License

Turkey-Sui-Builders/Suilor

Folders and files

Latest commit

History

Repository files navigation