KO'DJ

📖 Description

KO'DJ - ya'ni Koreyadagi O'zbek Dasturchilar Jamiyati bo'lib KO'DJ web sahifasi orqali dev uchrashuvlar, uchrashuvlarni topish va ularga ro'yhatdan o'tish va uchrashuvlar bo'yicha sarhisoblarni yoritib boruvchi va KO'DJ jamiyatini ravnaqi yo'lida xizmat qiluvchi web safiha hisoblanadi.

🚀 Getting Started

Prerequisites

• npm packages

Installation

# Clone the repository
git clone https://github.com/kodjdev/kodj_web_react

# Install dependencies
npm install


# Start development server
npm run dev

Open http://localhost:3000 to view the application.

🕹️ Main Features

• My Page: do somthing
• Favorite Backgrounds: do somthing

🔧 Technical Stack

Frontend Core

• React: UI library
• TypeScript: Type-safe JavaScript
• TailwindCSS: Utility-first CSS framework

State Management & Data Fetching

• React Query: Server state management
• Zustand: Client state management
• Axios: HTTP client

UI/UX

• Shadcn UI: Component library
• Framer Motion: Animation library
• React Hook Form: Form handling

Development Tools

• ESLint: Code linting
• Prettier: Code formatting
• Jest & React Testing Library: Testing

📁 Project Structure

src/
├── src/             # React root folder
├── components/      # Reusable components
├── hooks/           # Custom React hooks
├── lib/             # Utility functions
├── store/           # State management
└── types/           # TypeScript definitions

🔄 CI/CD

• GitHub Actions: Automated testing and deployment
• Firebase Hosting: Production hosting

🌐 Environment Variables

Create a .env.local file in the root directory:

VITE_FIREBASE_API_KEY = your_env_var
VITE_FIREBASE_AUTH_DOMAIN = your_env_var
VITE_FIREBASE_PROJECT_ID = your_env_var
VITE_FIREBASE_STORAGE_BUCKET = your_env_var
VITE_FIREBASE_MESSAGING_SENDER_ID = your_env_var
VITE_FIREBASE_APP_ID = your_env_var
VITE_USE_EMULATORS = false or true

📚 Available Scripts

npm run dev         # Start development server

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.