KaburAjaDul/kaburajadulu

🗺️ Roadmap

Table of Contents

1. What is KaburAjaDulu?
2. 🚀 Mission & Vision
3. 🛠️ Getting Started
• Prerequisites
• Installation
4. 📚 Project Structure
5. 🤝 Contributing
• Code Contributions
• Guidelines
• 🗺️ Roadmap

What is KaburAjaDulu?

KaburAjaDulu is an open-source platform helping Indonesians explore study and work opportunities abroad. Our mission is to provide accessible, accurate information and build a supportive community for those seeking international education and career paths.

🚀 Mission & Vision

We believe that international experience has the power to transform lives and broaden horizons. Our platform is dedicated to:

• Providing job opportunities: Gain access to insider insights on companies and referral networks. Many job openings are not publicly advertised, making these connections invaluable.

• Facilitating language learning: Benefit from expert guidance and firsthand advice from individuals who have successfully navigated the process of studying and working abroad.

• Sharing scholarship opportunities: Explore funding options, including scholarships and financial aid programs, to support international education.

• Offering expert mentorship: Learn from seasoned professionals who have successfully pursued global education and career paths

🛠️ Getting Started

Prerequisites

• Node.js 18.0 or higher
• npm, pnpm, yarn, or bun

Installation

Below is the procedure for installing the project:

For Development/Contributing

# Clone the repository
git clone https://github.com/KaburAjaDul/kaburajadulu.git

# Navigate to the project
cd kaburajadulu

# Switch to development branch
git checkout dev

# Install dependencies
bun install

# Start the development server
bun dev

# Build for production (test before contributing)
bun run build

For General Use

# Clone the repository (main branch)
git clone https://github.com/KaburAjaDul/kaburajadulu.git

# Navigate to the project
cd kaburajadulu

# Install dependencies
npm install
# or
pnpm install
# or
bun install

# Start the development server
npm run dev
# or
pnpm dev
# or
bun dev

📚 Project Structure

/
├── public/            # Static assets (images, icons, etc.)
├── src/
│   ├── components/    # React/Astro components
│   │   ├── home/      # Landing page sections
│   │   ├── layout/    # Layout components (Header, Footer)
│   │   └── ui/        # UI primitives (Button, Card, etc.)
│   ├── constants/     # Application constants
│   ├── layouts/       # Astro layout templates
│   ├── lib/           # Utility functions
│   ├── pages/         # File-based routing (.astro files)
│   └── styles/        # Global CSS styles
├── astro.config.mjs   # Astro configuration
└── package.json

🤝 Contributing

We welcome contributions from everyone! Here's how you can help:

Code Contributions

1. Fork the repository
2. Switch to the dev branch (important for contributors):

   git checkout dev

3. Create a feature branch from dev:

   git checkout -b feature/amazing-feature

4. Make your changes and test them:

   # Test your changes
   bun run build
   
   # Ensure the build passes before committing

5. Commit your changes:

   git commit -m 'Add some amazing feature'

6. Push to the branch:

   git push origin feature/amazing-feature

7. Open a Pull Request targeting the dev branch (not main)

Guidelines

• Follow the existing code style and conventions
• Write a clear, descriptive commit messages
• Update documentation as needed
• Add or update tests where possible
• Be respectful and constructive in discussions

🗺️ Roadmap

• Landing page with basic information
• Blog with guides and resources
• Curated list of scholarship, programs, and job opportunities
• More to come...

---

Built with ❤️ by the KaburAjaDulu Community