StarkHive API

Welcome to the StarkHive API – the backend service powering StarkHive, a decentralized Web3 job marketplace built on Starknet. This platform connects freelancers and recruiters through a LinkedIn-style feed and Upwork-style job interactions, tailored for the blockchain and developer community.

🚀 Tech Stack

• Framework: NestJS (TypeScript)
• ORM: TypeORM
• Database: PostgreSQL

🛠 Features Overview

• 🔐 Auth (JWT, refresh tokens, RBAC)
• 🧑‍💻 Freelancer & Recruiter onboarding
• 💼 Job Posting and Applications
• 📰 Social Feed with likes, comments, and saves
• 🛡️ Admin tools for moderation
• 📬 Notifications
• 📁 Portfolios & Profiles
• 💬 Messaging (initial structure)

📦 Project Structure

src/
├── auth/            → user registration, login, roles, profiles
├── jobs/            → job creation, applications, status
├── feed/            → posts, likes, comments, reports
├── notifications/   → user alerts, preferences
├── applications/    → job applications
├── messaging/       → direct messages
├── anti-spam/       → spam detection & flagging
├── reviews/         → freelancer reviews

💡 Getting Started

git clone https://github.com/your-org/StarkHive_api.git
cd StarkHive_api
npm install
npm run start:dev

• Copy .env.example to .env and fill in your config. Add your .env to .gitignore.
• Ensure PostgreSQL is running.

📋 Contribution Guide

We’re building this together. Here’s how to contribute:

👇 To work on an issue:

1. Browse the open Issues.
2. Choose an issue (look for ones without an assignee).
3. Comment on the issue with: Maintainers, I would like to work on this issue, with an estimated ETA.
4. Wait for assignment. (Please don’t create PRs without assignment.)

✅ After assignment:

• Fork the repo.
• Create a branch: git checkout -b feat/your-feature-name
• Code and make sure to test your changes.
• Submit a PR that includes Close #ISSUE_NUMBER in the description.

🤝 Rules Before Starting:

• Always wait for a maintainer to assign the issue.
• Join our Telegram Group for questions, collabs, or help.
• ⭐ Star the repo if you find this project valuable.

📄 License

MIT

---

Built with 💙 by the StarkHive community