Skip to content

10Pratik01/Beacon

Repository files navigation

BEACON πŸš€

Your AI-Powered Career Advancement Platform

BEACON is a comprehensive career development platform that leverages AI to help professionals advance their careers through personalized learning paths, skill assessments, and intelligent career guidance.

✨ Features

🎯 Dashboard

  • Personalized career insights and recommendations
  • Progress tracking across all modules
  • Quick access to key features

πŸ“š Study Material

  • AI-Generated Roadmaps: Get customized learning paths for any subject
    • Interactive timeline with learning phases
    • Clickable resources (YouTube, GitHub, documentation)
    • Project ideas with tutorial links
    • Skills breakdown for each phase
  • Folder Management: Organize your study topics
    • Create folders for different subjects
    • Add topics to folders
    • Generate AI-powered content for each topic
  • Content Generation: 5 types of AI-generated study materials
    • Comprehensive notes
    • Concise summaries
    • Mind maps
    • Practice questions with answers
    • Quick revision notes

πŸ’Ό Resume Builder

  • AI-powered resume creation and optimization
  • ATS score analysis
  • Personalized feedback
  • Export to PDF

πŸ“ Cover Letter Generator

  • Tailored cover letters for specific job applications
  • AI suggestions based on job descriptions
  • Professional formatting

🎀 Interview Preparation

  • Mock interview questions
  • AI-powered feedback
  • Industry-specific practice
  • Performance analytics
  • Question review with explanations

πŸ“Š Industry Insights

  • Market trends and analysis
  • Skill demand forecasting
  • Career path recommendations
  • Salary insights

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • PostgreSQL database
  • Clerk account for authentication
  • Google Gemini API key
  • Inngest account for background jobs

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/beacon.git
cd beacon
  1. Install dependencies:
npm install
  1. Set up environment variables: Create a .env file in the root directory:
# Database
DATABASE_URL="postgresql://user:password@localhost:5432/beacon"

# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
CLERK_SECRET_KEY=your_clerk_secret_key
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up

# Google Gemini AI
GEMINI_API_KEY=your_gemini_api_key

# Inngest
INNGEST_EVENT_KEY=your_inngest_event_key
INNGEST_SIGNING_KEY=your_inngest_signing_key
  1. Set up the database:
npx prisma generate
npx prisma db push
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

πŸ› οΈ Tech Stack

  • Framework: Next.js 16 (App Router)
  • Language: TypeScript
  • Database: PostgreSQL with Prisma ORM
  • Authentication: Clerk
  • AI: Google Gemini API
  • Styling: Tailwind CSS
  • UI Components: shadcn/ui + Radix UI
  • Animations: Framer Motion
  • Form Handling: React Hook Form + Zod
  • Background Jobs: Inngest
  • Charts: Recharts

πŸ“ Project Structure

beacon/
β”œβ”€β”€ app/                    # Next.js app directory
β”‚   β”œβ”€β”€ (auth)/            # Authentication pages
β”‚   β”œβ”€β”€ (main)/            # Main application routes
β”‚   β”‚   β”œβ”€β”€ dashboard/     # Dashboard page
β”‚   β”‚   β”œβ”€β”€ study-material/# Study material module
β”‚   β”‚   β”œβ”€β”€ resume/        # Resume builder
β”‚   β”‚   β”œβ”€β”€ cover-letter/  # Cover letter generator
β”‚   β”‚   β”œβ”€β”€ interview/     # Interview prep
β”‚   β”‚   └── onboarding/    # User onboarding
β”‚   └── api/               # API routes
β”‚       └── inngest/       # Background job handlers
β”œβ”€β”€ actions/               # Server actions
β”‚   β”œβ”€β”€ dashboard.ts       # Dashboard data
β”‚   β”œβ”€β”€ studyMaterial.ts   # Study material logic
β”‚   β”œβ”€β”€ interview.ts       # Interview logic
β”‚   └── user.ts            # User management
β”œβ”€β”€ components/            # Reusable components
β”‚   └── ui/                # shadcn/ui components
β”œβ”€β”€ lib/                   # Utility functions
β”‚   β”œβ”€β”€ inngest/           # Inngest client & functions
β”‚   β”œβ”€β”€ prisma.ts          # Prisma client
β”‚   └── schema.ts          # Zod validation schemas
β”œβ”€β”€ prisma/               # Database schema
β”‚   └── schema.prisma      # Prisma schema definition
└── public/               # Static assets

🎨 Key Features in Detail

Study Material System

  • Folders: Organize topics by subject or category
  • Topics: Individual study items within folders
  • AI Content Generation:
    • Notes: Comprehensive study material
    • Summary: Quick overview
    • Mindmap: Visual concept mapping
    • Questions: Practice with answers
    • Revision Notes: Quick review points
  • Roadmaps: AI-generated learning paths with:
    • Learning phases with timelines
    • Core topics breakdown
    • Recommended resources with links
    • Project ideas with tutorials
    • Skills to master per phase

Interview Preparation

  • Category-based quizzes
  • Detailed performance analytics
  • Question review with explanations
  • Improvement tips
  • Progress tracking

Industry Insights Dashboard

  • Visual analytics with interactive charts
  • Salary benchmarking
  • Growth rate tracking
  • Skills intelligence
  • Market trends

πŸ”’ Authentication

BEACON uses Clerk for secure authentication with support for:

  • Email/Password
  • Social login (Google, GitHub, etc.)
  • Multi-factor authentication
  • User management

πŸ—„οΈ Database Schema

Key models:

  • User: User profiles and authentication
  • Folder: Study material folders
  • Topic: Individual study topics
  • Roadmap: AI-generated learning paths
  • Resume: User resumes
  • CoverLetter: Generated cover letters
  • Assessment: Interview quiz results
  • IndustryInsight: Market data and trends

🚒 Deployment

Vercel (Recommended)

  1. Push your code to GitHub
  2. Import project in Vercel
  3. Add environment variables
  4. Update build command to include migrations:
    prisma migrate deploy && next build
    
  5. Deploy

Database Migration in Production

Ensure your production database has the latest schema:

npx prisma migrate deploy

οΏ½ Security & Privacy

  • Encrypted data storage
  • Secure authentication with Clerk
  • Privacy controls
  • GDPR compliant

οΏ½ Roadmap

  • Mobile app (iOS & Android)
  • LinkedIn profile optimization
  • Job application tracking
  • Networking recommendations
  • Salary negotiation assistant
  • Career path visualization
  • Mentorship matching

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

πŸ“„ License

This project is licensed under the MIT License.

πŸ™ Acknowledgments

  • Next.js team for the amazing framework
  • Vercel for hosting
  • Clerk for authentication
  • Google for Gemini AI
  • shadcn for beautiful UI components
  • Prisma for excellent database tooling

Built with ❀️ to help professionals take their next step in their career journey.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published