https://github.com/nexeosai/studentlyapp
https://github.com/nexeosai/studentlyapp
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/nexeosai/studentlyapp
- Owner: NexeosAI
- Created: 2024-12-15T22:38:05.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-12-18T10:48:05.000Z (over 1 year ago)
- Last Synced: 2025-04-08T22:26:16.476Z (about 1 year ago)
- Language: TypeScript
- Size: 500 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
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