Sproutern

AI-Powered Career Platform for Students & Freshers
200+ Tools · 180+ Games · AI Resume Builder · Career Roadmaps

Explore Sproutern »

Report Bug · Request Feature · Ask a Question

---

📋 Table of Contents

• About Sproutern
• ✨ Features
• 🛠️ Tech Stack
• 🚀 Getting Started
• 📁 Project Structure
• 🧪 Scripts
• 🤝 Contributing
• 📄 License
• 🌟 Support

---

🎯 About Sproutern

Sproutern is a comprehensive, open-source career platform designed to empower students, freshers, and professionals worldwide. Built with Next.js 16 and Firebase, it offers an extensive ecosystem of tools, interactive games, AI-powered career guidance, and educational content — all free and accessible to everyone.

Why Sproutern?

• Complete Career Ecosystem: From resume optimization to interview preparation, everything in one place
• AI-Powered: Leverages Google Genkit AI for intelligent career assistance
• Massive Tool Library: 200+ professional tools covering every aspect of career development
• Gamified Learning: 180+ interactive games that make skill-building engaging
• Truly Open Source: MIT licensed — contribute, customize, and self-host

---

✨ Features

🧰 Career Tools (200+)

A vast collection of professional tools including:

• Resume & CV builders with AI optimization
• CGPA, GPA, and grade calculators
• Salary calculators, tax estimators, budget planners
• SOP generators, cover letter builders
• Interview question banks, mock interviews
• Skill assessments, career path finders
• Coding tools, unit converters, and much more

🎮 Interactive Games (180+)

Learn while having fun with educational games:

• Typing tests, memory games, puzzle challenges
• Technical quizzes and coding challenges
• Brain training, logic puzzles, and more

🤖 AI-Powered Career Suite

• Resume Optimizer: AI-driven analysis and improvement suggestions
• Cold Email Generator: Smart templates for professional outreach
• SOP Outline Generator: AI-assisted Statement of Purpose drafting
• Interview Coach: AI-powered interview preparation and feedback
• Career Roadmap Generator: Personalized career path recommendations

📚 Educational Content

• 2000+ programmatic SEO-optimized blog posts
• Company-specific interview experiences
• Global career guides for multiple countries
• Tech and non-tech career roadmaps
• Skill development resources

🌍 Global Reach

• Multi-language SEO support
• Country-specific career guidance
• Regional job market insights
• International education resources

---

🛠️ Tech Stack

Technology	Purpose
Next.js 16 (App Router)	React framework with server components
TypeScript 5	Type-safe development
Firebase	Auth, Firestore, Storage, Hosting, FCM
Google Genkit AI	AI-powered features (Gemini)
Tailwind CSS 3	Utility-first styling
Shadcn UI & Radix UI	Accessible component library
Framer Motion	Animations & transitions
Jest & Playwright	Testing (unit + E2E)
Vercel	Deployment & hosting

---

🚀 Getting Started

Prerequisites

• Node.js v18+
• npm or yarn
• A Firebase project (for auth, database, and storage)

Installation

# Clone the repository
git clone https://github.com/itsPremkumar/sproutern-open-source.git
cd sproutern-open-source

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your Firebase credentials

# Start development server
npm run dev

The app will be available at http://localhost:9002.

No Firebase? No problem! The app runs in degraded mode without Firebase. Most tools and games work without any configuration.

Environment Variables

Copy .env.example to .env.local and fill in your Firebase project credentials:

Variable	Description	Required
NEXT_PUBLIC_FIREBASE_API_KEY	Firebase API key	Optional (degraded mode)
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN	Firebase auth domain	Optional
NEXT_PUBLIC_FIREBASE_PROJECT_ID	Firebase project ID	Optional
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET	Firebase storage bucket	Optional
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID	Firebase sender ID	Optional
NEXT_PUBLIC_FIREBASE_APP_ID	Firebase app ID	Optional

Deployment

Deploy to Vercel with zero configuration:

No environment variables are required — the app runs with graceful fallbacks.

---

📁 Project Structure

sproutern-open-source/
├── .github/               # GitHub templates & CI/CD workflows
├── docs/                  # Documentation
├── public/                # Static assets
├── scripts/               # PSEO, content, and maintenance scripts
├── src/
│   ├── ai/                # Genkit AI flows & configurations
│   ├── app/               # Next.js App Router (pages & API routes)
│   │   ├── api/           # API endpoints
│   │   ├── games/         # 180+ educational games
│   │   ├── tools/         # 200+ career tools
│   │   └── ...            # Feature pages
│   ├── components/        # Reusable UI components
│   ├── content/           # Markdown content (blogs, guides)
│   ├── hooks/             # Custom React hooks
│   ├── lib/               # Utilities, Firebase, helpers
│   └── types/             # TypeScript type definitions
├── tests/                 # Unit & E2E tests
├── .editorconfig
├── .env.example
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── LICENSE
├── next.config.ts
├── package.json
├── SECURITY.md
├── SUPPORT.md
├── tsconfig.json
└── vercel.json

---

🧪 Scripts

Command	Description
npm run dev	Start dev server on port 9002
npm run build	Production build
npm run start	Start production server
npm run lint	Run ESLint
npm run format	Format with Prettier
npm run typecheck	TypeScript type checking
npm run test	Run Jest unit tests
npm run test:e2e	Run Playwright E2E tests

---

🤝 Contributing

We welcome contributions of all kinds! Here's how you can help:

• 🐛 Report Bugs: Open a bug report
• 💡 Suggest Features: Submit a feature request
• 📝 Improve Docs: Help make documentation better
• 🔧 Fix Issues: Check good first issues
• 🎮 Add Tools/Games: Build new tools in src/app/tools/ or games in src/app/games/
• 🌍 Translations: Help with i18n and multi-language support

Please read our Contributing Guide and Code of Conduct before getting started.

Quick Start for Contributors

# Fork & clone
git clone https://github.com/YOUR-USERNAME/sproutern-open-source.git
cd sproutern-open-source
npm install

# Create a branch
git checkout -b feature/your-feature

# Make changes and verify
npm run typecheck
npm run lint
npm run test

# Commit and push
git commit -m "feat: add your feature"
git push origin feature/your-feature

# Open a Pull Request

---

📄 License

This project is MIT licensed — feel free to use, modify, and distribute.

---

🌟 Support

• 📖 Documentation
• 💬 GitHub Discussions
• 🐛 Report a Bug
• 🔒 Security Issues

---

_{Built with ❤️ by Premkumar Manivel and contributors
⭐ Star us on GitHub — it helps others discover the project!}