nexhremployee

An employee mobile app for nexHR (Flutter)

---

What the project does

nexhremployee is a Flutter-based mobile application that provides employee-facing features for the nexHR platform — authentication, project and task views, notifications, and basic analytics. The app uses Supabase as its backend (auth + database) and contains UI components and pages to support tasks, projects, and profile workflows.

Why this project is useful

• Mobile-first employee experience for nexHR
• Ready-made UI components and pages (projects, tasks, notifications, chats, profile)
• Supabase-backed for easy local development and quick backend prototyping
• Uses modern Flutter tooling and recommended linting (flutter_lints)

Quick badges

---

Get started — Installation & setup

Prerequisites:

• Flutter SDK (this project is using Dart/Flutter compatible with SDK constraint ^3.6.1 — see pubspec.yaml)
• A Supabase project (URL + anon key) for local development

Steps:

1. Clone the repository:

git clone <repo-url>
cd nexhremployee

2. Install dependencies:

flutter pub get

3. Create an environment file for development in assets/.env (this file is loaded in debug mode by lib/main.dart):

NEXT_PUBLIC_SUPABASE_URL=your-supabase-url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

4. Run the app on an emulator or device:

flutter run

5. Build release artifacts:

flutter build apk   # Android
flutter build ios   # iOS (macOS required)

Notes:

• In production you should configure secrets using secure CI/CD secrets or platform-specific environment mechanisms instead of committing assets/.env.
• The app initializes Supabase in lib/main.dart and expects the two environment variables above.

Usage examples & developer tips

• Entry point: lib/main.dart (initializes Supabase and launches AppNavigator).
• Key pages and features are under lib/pages/ and lib/components/.
• Linting: flutter analyze and tests: flutter test

Contributing & getting help

If you need help or want to contribute:

• Open an issue for bugs or feature requests.
• Fork the repo, create a branch (e.g., fix/<short-description>), make changes, add tests, and open a pull request.
• Please follow the coding conventions and run flutter analyze before submitting.

See CONTRIBUTING.md for a short contribution guide.

Maintainers & Copyright

Maintained by the nexHR team. Please check commit history or the repository owners for more details. If your team would like a dedicated MAINTAINERS file, add one and we will link it here.

Where to get help

• Create an issue in this repository.
• Refer to the official Flutter docs: https://docs.flutter.dev/
• For Supabase setup see: https://supabase.com/docs

---

If you'd like, I can also add a minimal CONTRIBUTING.md file with PR guidelines and a simple issue template — let me know and I'll add it.