forked from Pymmdrza/ticketfy
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit 7495c6f
Showing
34 changed files
with
5,616 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
# Logs | ||
logs | ||
*.log | ||
npm-debug.log* | ||
yarn-debug.log* | ||
yarn-error.log* | ||
pnpm-debug.log* | ||
lerna-debug.log* | ||
|
||
node_modules | ||
dist | ||
dist-ssr | ||
*.local | ||
|
||
# Editor directories and files | ||
.vscode/* | ||
!.vscode/extensions.json | ||
.idea | ||
.DS_Store | ||
*.suo | ||
*.ntvs* | ||
*.njsproj | ||
*.sln | ||
*.sw? |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,132 @@ | ||
# Ticketfy - Modern Support Ticket System | ||
|
||
<center><img src="./ticketfy-header.png" title="TicketFy - Modern | ||
Dashboard Ui" style="border-radius: 10px;margin: 5px; display: block"/></center> | ||
|
||
A modern, responsive, and feature-rich support ticket management system built with React, TypeScript, and Tailwind CSS. Ticketfy provides a seamless experience for both users and administrators in managing support requests. | ||
|
||
## ✨ Features | ||
|
||
- 🎨 Modern Dark Theme UI with Professional Design | ||
- 📱 Fully Responsive Layout (Mobile, Tablet, Desktop) | ||
- 🔐 User Authentication System | ||
- 📊 Advanced Admin Dashboard | ||
- 🎫 Comprehensive Ticket Management | ||
- 📨 Real-time Notifications | ||
- 📁 File Attachment Support | ||
- 🔍 Advanced Search & Filtering | ||
- 📈 Analytics Dashboard | ||
- 🌐 Multi-language Support Ready | ||
- 🔒 Role-based Access Control | ||
- ⚡ Lightning Fast Performance | ||
|
||
## 🚀 Quick Start | ||
|
||
### One-Command Setup (Linux) | ||
|
||
```bash | ||
curl -sSL https://raw.githubusercontent.com/Pymmdrza/ticketfy/main/setup.sh | sh | ||
``` | ||
|
||
### Manual Installation | ||
|
||
1. Clone the repository: | ||
```bash | ||
git clone https://github.com/Pymmdrza/ticketfy.git | ||
cd ticketfy | ||
``` | ||
|
||
2. Install dependencies: | ||
```bash | ||
npm install | ||
``` | ||
|
||
3. Start development server: | ||
```bash | ||
npm run dev | ||
``` | ||
|
||
## 🛠️ Tech Stack | ||
|
||
- **Frontend**: React 18.3 | ||
- **Type Safety**: TypeScript | ||
- **Styling**: Tailwind CSS | ||
- **Icons**: Lucide React | ||
- **State Management**: React Context | ||
- **Routing**: React Router DOM | ||
- **Build Tool**: Vite | ||
- **Code Quality**: ESLint | ||
- **Package Manager**: npm | ||
|
||
## 📁 Project Structure | ||
|
||
``` | ||
ticketfy/ | ||
├── src/ | ||
│ ├── components/ # Reusable UI components | ||
│ │ ├── ui/ # Base UI components | ||
│ │ ├── layout/ # Layout components | ||
│ │ └── dashboard/ # Dashboard specific components | ||
│ ├── pages/ # Page components | ||
│ ├── lib/ # Utilities and helpers | ||
│ ├── types/ # TypeScript definitions | ||
│ ├── hooks/ # Custom React hooks | ||
│ └── contexts/ # React contexts | ||
├── public/ # Static assets | ||
└── package.json # Project configuration | ||
``` | ||
|
||
## 📝 Available Scripts | ||
|
||
- `npm run dev` - Start development server | ||
- `npm run build` - Build for production | ||
- `npm run preview` - Preview production build | ||
- `npm run lint` - Run ESLint | ||
|
||
## ⚙️ Configuration | ||
|
||
Create a `.env` file in the root directory: | ||
|
||
```env | ||
VITE_API_URL=your_api_url_here | ||
VITE_APP_NAME=Ticketfy | ||
VITE_APP_VERSION=1.0.0 | ||
``` | ||
|
||
## 🌐 Browser Support | ||
|
||
- Chrome (latest) | ||
- Firefox (latest) | ||
- Safari (latest) | ||
- Edge (latest) | ||
|
||
## 🤝 Contributing | ||
|
||
1. Fork the repository | ||
2. Create your feature branch: | ||
```bash | ||
git checkout -b feature/amazing-feature | ||
``` | ||
3. Commit your changes: | ||
```bash | ||
git commit -m 'Add amazing feature' | ||
``` | ||
4. Push to the branch: | ||
```bash | ||
git push origin feature/amazing-feature | ||
``` | ||
5. Open a Pull Request | ||
|
||
## 📄 License | ||
|
||
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. | ||
|
||
## 🆘 Support | ||
|
||
- Documentation: [docs.ticketfy.com](https://docs.ticketfy.com) | ||
- Issues: [GitHub Issues](https://github.com/Pymmdrza/ticketfy/issues) | ||
- Email: [email protected] | ||
|
||
## 🌟 Credits | ||
|
||
Created and maintained by [Pymmdrza](https://github.com/Pymmdrza). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,28 @@ | ||
import js from '@eslint/js'; | ||
import globals from 'globals'; | ||
import reactHooks from 'eslint-plugin-react-hooks'; | ||
import reactRefresh from 'eslint-plugin-react-refresh'; | ||
import tseslint from 'typescript-eslint'; | ||
|
||
export default tseslint.config( | ||
{ ignores: ['dist'] }, | ||
{ | ||
extends: [js.configs.recommended, ...tseslint.configs.recommended], | ||
files: ['**/*.{ts,tsx}'], | ||
languageOptions: { | ||
ecmaVersion: 2020, | ||
globals: globals.browser, | ||
}, | ||
plugins: { | ||
'react-hooks': reactHooks, | ||
'react-refresh': reactRefresh, | ||
}, | ||
rules: { | ||
...reactHooks.configs.recommended.rules, | ||
'react-refresh/only-export-components': [ | ||
'warn', | ||
{ allowConstantExport: true }, | ||
], | ||
}, | ||
} | ||
); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
<!DOCTYPE html> | ||
<html lang="en"> | ||
<head> | ||
<meta charset="UTF-8" /> | ||
<link rel="icon" type="image/svg+xml" href="/vite.svg" /> | ||
<meta name="viewport" content="width=device-width, initial-scale=1.0" /> | ||
<meta name="description" content="Modern support ticket system with real-time notifications, file attachments, and comprehensive admin dashboard for efficient customer support management" /> | ||
<meta name="keywords" content="support, ticket system, customer service, help desk" /> | ||
<meta name="author" content="Support Desk" /> | ||
<meta name="theme-color" content="#1a1b1e" /> | ||
<title>TicketFy - Professional Ticket Management System</title> | ||
</head> | ||
<body> | ||
<div id="root"></div> | ||
<script type="module" src="/src/main.tsx"></script> | ||
</body> | ||
</html> |
Oops, something went wrong.