StarkMinds-Frontend

StarkMinds-Frontend is the user interface for StarkMinds—a cutting-edge blockchain education platform built on Stellar. Developed with ReactJS/Next.js, this repository delivers a responsive, engaging, and intuitive experience for learners accessing interactive courses and real-time blockchain data.

Features
• Interactive UI built with ReactJS/Next.js for dynamic content and fast navigation
• Responsive design ensuring optimal experience on desktop, mobile, and tablet
• Integration with the backend API for course management and user progress tracking
• Clean, modular components adhering to modern UI/UX best practices
• Performance optimization, code splitting, and client-side caching
• Authentication flows integrated with JWT/OAuth

Getting Started

Prerequisites:
• Node.js v18 or higher
• pnpm (recommended) or npm

Installation:

1. Clone the repository:
   git clone https://github.com/your-username/strellerminds-frontend.git
2. Change to the project directory:
   cd strellerminds-frontend
3. Install dependencies:
   pnpm install (or npm install)
4. Create a .env file using the provided .env.example for environment-specific configurations.
5. Start the development server:
   pnpm run dev (or npm run dev)

Available Scripts

• pnpm run dev - Start development server • pnpm run build - Build for production • pnpm run start - Start production server • pnpm run lint - Run ESLint • pnpm run lint:fix - Fix ESLint errors automatically • pnpm run format - Format code with Prettier • pnpm run format:check - Check code formatting • pnpm run type-check - Run TypeScript type checking • pnpm run test - Run tests (placeholder) • pnpm run ci - Run all CI checks locally

CI/CD Pipeline

This project includes a comprehensive GitHub Actions workflow that automatically runs on pull requests and pushes to main/develop branches. The CI pipeline includes:

• Type Check - Runs tsc --noEmit to verify TypeScript types • Lint - Runs ESLint to check code quality and style • Format Check - Verifies code formatting with Prettier • Build - Ensures the project builds successfully • Test - Runs tests (when available)

All checks must pass before pull requests can be merged. You can run the same checks locally using:

pnpm run ci

Contribution Guidelines

• Fork the repository and create a feature branch.
• Adhere to the established coding standards and use ESLint/Prettier for formatting.
• Run pnpm run ci locally before submitting a pull request. • Ensure UI changes are tested across different screen sizes.
• Submit a pull request with clear documentation of your enhancements. • All CI checks must pass before your PR can be merged.

Contact
For any issues or suggestions, please open an issue or reach out to the project maintainers.