OpenPecha Frontend

This is the frontend application for the OpenPecha platform, designed to manage and interact with Buddhist texts in the OpenPecha format.

Prerequisites

• Node.js (v18 or higher)
• npm (v9 or higher)

Installation

1. Clone the repository:

   git clone https://github.com/OpenPecha/app-pecha-frontend.git

2. Navigate to app-pecha-frontend directory:

   cd app-pecha-frontend

3. Install the dependencies:

   npm install

Development

1. Start the development server:

   npm run dev

   The application will be available at http://localhost:5173

2. Run the test cases:

   npm run test

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
• npm run test - Run tests
• npm run coverage - Generate test coverage report

Key Features

• Modern React-based frontend
• Internationalization support via tolgee
• Authentication via Auth0
• Responsive UI with React Bootstrap
• State management with React Query

Tech Stack

• React 18
• React Router DOM
• React Bootstrap
• Auth0 React
• tolgee
• React Query
• Vite
• Vitest

Docker Support

Build and run using Docker:

# Build the Docker image
docker build -t app-pecha-frontend .

# Run the container
docker run -p 80:80 app-pecha-frontend

Contributing

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

License

This project is licensed under the MIT License.