Konsulin App

An open source digital wellness app

Architecture

• FHIR Integration: Blaze FHIR server for healthcare data storage (FHIR R4 compliant)
• Authentication: SuperTokens with magic link authentication
• Frontend Framework: Next.js with React and TypeScript
• Styling: Tailwind CSS with Radix UI components
• Backend Integration: Works alongside the Konsulin API as the API gateway

Features

• Psychological Instruments: Access to various psychometric tools and assessments
• Digital Interventions: Evidence-based exercises for self-compassion, mindfulness, and mental health
• Appointment Management: Schedule and manage appointments with psychologists
• Payment Gateway: Secure payment processing for healthcare services
• FHIR-Compliant Health Records: Comprehensive health record management using FHIR R4 standards
• Real-time Communication: Messaging and notification system
• Responsive Design: Optimized for desktop, tablet, and mobile devices

Prerequisites

Make sure you have the following installed:

• Node.js (v20.x)
• npm

Local Development Setup

1. Backend Service Setup

This frontend application requires the Konsulin API backend service to be running. Please follow the backend setup instructions first to ensure the API gateway is available.

2. Frontend Setup

1. Clone this repository:

   git clone [email protected]:konsulin-care/fe-konsulin.git
   cd fe-konsulin

2. Install the dependencies:

   npm install

3. Set up environment variables:

   • Copy the environment configuration file
   • Update the API endpoints to point to your local backend service

4. Start the development server:

   npm run dev

The application will be available at http://localhost:3000.

3. Running Both Services

For full local development, ensure both services are running:

1. Backend API: Running on http://localhost:8080 (or your configured port)
2. Frontend: Running on http://localhost:3000

The frontend will communicate with the backend API for all data operations, authentication, and FHIR resource management.

Available Scripts

• npm run dev - Start the development server
• npm run build - Build the application for production
• npm run start - Start the production server
• npm run lint - Run ESLint for code quality checks
• npm run format - Format code using Prettier

Technology Stack

• Framework: Next.js 14+ with App Router
• Language: TypeScript
• Styling: Tailwind CSS
• UI Components: Radix UI
• Authentication: SuperTokens
• Data Fetching: React Query
• Form Management: React Hook Form with Zod validation
• Healthcare Standards: FHIR R4 compliance
• Development Tools: ESLint, Prettier, Husky

Contributing

1. Ensure both frontend and backend services are running locally
2. Follow the established coding standards and patterns
3. Test your changes across different user roles (patient, practitioner, admin)
4. Ensure FHIR compliance for any healthcare data operations

License

Konsulin is distributed under the AGPL-3.0 License. You may not use Konsulin's logo for other projects. Commercial licenses are available for organizations that wish to use this software without AGPL obligations. Contact [email protected] to obtain a commercial license.