An open API service indexing awesome lists of open source software.

https://github.com/nexeosai/studentlyapp


https://github.com/nexeosai/studentlyapp

Last synced: 10 months ago
JSON representation

Awesome Lists containing this project

README

          

# StudentlyAI App

StudentlyAI is a comprehensive student management application powered by advanced AI capabilities, designed to enhance the learning experience for students with diverse needs.

## ๐ŸŒŸ Features

- ๐Ÿค– **AI-Powered Learning Assistant**
- Personalized learning recommendations
- Intelligent content generation
- Real-time study assistance

- ๐ŸŽจ **Adaptive Interface**
- Dark/Light theme support
- Responsive design
- Accessibility-first approach

- ๐Ÿ” **Secure Authentication**
- OAuth integration (Google, GitHub)
- Role-based access control
- Secure session management

- ๐ŸŒ **Internationalization**
- Multi-language support
- Locale-based content adaptation
- RTL support

## ๐Ÿš€ Getting Started

### Prerequisites

- Node.js (v18 or higher)
- npm or yarn
- Git

### Installation

1. Clone the repository:
```bash
git clone https://github.com/NexeosAI/StudentlyApp.git
cd StudentlyApp
```

2. Install dependencies:
```bash
npm install
# or
yarn install
```

3. Create a `.env` file based on `.env.example`:
```bash
cp .env.example .env
```

4. Start the development server:
```bash
npm run dev
# or
yarn dev
```

The app will be available at `http://localhost:5173`

## ๐Ÿ› ๏ธ Built With

- **Frontend Framework**: React 18
- **Build Tool**: Vite
- **Type Safety**: TypeScript
- **Styling**: Tailwind CSS
- **UI Components**: Radix UI
- **State Management**: Zustand
- **API Integration**: TanStack Query
- **AI Integration**: OpenAI
- **Icons**: Lucide React

## ๐Ÿ“ฆ Project Structure

```
src/
โ”œโ”€โ”€ components/ # Reusable UI components
โ”œโ”€โ”€ layouts/ # Page layouts
โ”œโ”€โ”€ lib/ # Utilities and configurations
โ”‚ โ”œโ”€โ”€ api/ # API clients and endpoints
โ”‚ โ”œโ”€โ”€ config/ # App configurations
โ”‚ โ”œโ”€โ”€ hooks/ # Custom React hooks
โ”‚ โ”œโ”€โ”€ store/ # State management
โ”‚ โ””โ”€โ”€ types/ # TypeScript types
โ”œโ”€โ”€ pages/ # Application pages
โ””โ”€โ”€ styles/ # Global styles
```

## ๐Ÿงช Scripts

- `npm run dev` - Start development server
- `npm run build` - Build for production
- `npm run build:prod` - Production build with optimizations
- `npm run analyze` - Analyze bundle size
- `npm run lint` - Run ESLint
- `npm run preview` - Preview production build

## ๐Ÿค Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## ๐Ÿ“ License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## ๐Ÿ™ Acknowledgments

- [React](https://reactjs.org/)
- [Vite](https://vitejs.dev/)
- [Tailwind CSS](https://tailwindcss.com/)
- [Radix UI](https://www.radix-ui.com/)
- [OpenAI](https://openai.com/)

---

Made with โค๏ธ by NexeosAI