Niramay

Traditional Kitchen Remedies

A privacy-first, offline-friendly web app for exploring traditional Assamese and Indian kitchen remedies, medicinal plants, seasonal living guidance, and everyday wellness knowledge — entirely on your device.

Live Demo · Releases · Report an Issue

Home	Explore

Command Palette	AI Assistant

Categories	Knowledge Library	Menu

• Rooted in Assamese culture. Remedies are written for Assamese households first — the interface, search, and AI assistant all understand অসমীয়া and Roman Assamese, not just English.
• Designed for everyday access. A kitchen-shelf approach: find a remedy, check an ingredient, follow a step — in under a minute, on a low-end phone.
• Local-first philosophy. Everything runs in the browser. No accounts, no cloud database, no analytics.
• Traditional knowledge, organized. Scattered household wisdom — kadhas, spice pastes, seasonal routines — presented as a structured, searchable reference.
• Safety-first interaction design. Educational content is clearly separated from emergency guidance; severe-symptom cues always take priority.

        User
         │
         ▼
  Niramay Web App (Next.js static export)
         │
         ▼
  Local search · knowledge engine · intent matching
  (runs entirely in the browser)
         │
         ▼
  Browser storage (localStorage) · PWA offline cache

Niramay is a fully static web app. There is no backend server, no database, and no external AI service. Search, the AI assistant, and all tools run locally in your browser; preferences and saved items are stored in localStorage; the PWA cache serves the app offline.

• No account or login. Nothing to sign up for.
• No cloud database. All remedy and plant content ships inside the app.
• No analytics or tracking. The app makes no telemetry calls.
• Browser storage only. Saved remedies, preferences, and logs live in your browser's localStorage. Clearing site data removes them permanently.
• Voice input is optional. If you use voice, your browser's speech-recognition API requires microphone permission; you can decline and type instead. (Speech support depends on your browser.)
• Offline by default. After the first visit, the PWA serves from cache.

Anyone may:

• visit the live web application;
• use its available features for their intended personal and educational purposes;
• install Niramay as a PWA where their browser supports it.

Using the deployed application does not grant ownership of, or any source-code reuse rights in, the project.

Source code. The original Niramay source code is proprietary (All Rights Reserved) unless explicitly stated otherwise. The repository is publicly viewable, but public visibility does not make the source open-source, and viewing it does not grant permission to copy, redistribute, sublicense, or create derivative projects. A public GitHub repository is not the same thing as free source code — see License and REUSE_POLICY.md.

Owner rights. The project owner may modify and reuse their own original code, create private or public forks of their own work, commercialize it, and relicense it in the future, subject to the licenses governing any third-party components or assets. Details: LICENSE.md and REUSE_POLICY.md.

Niramay provides educational information about traditional household practices and wellness knowledge. It is not a substitute for diagnosis, treatment, or professional medical advice.

• In an emergency, contact your local emergency services immediately.
• Seek professional medical advice for severe, persistent, or worsening symptoms — the app will remind you of the same.
• Age-group dosage guidance is general educational information, never personalized medical advice.
• Traditional practices are cultural knowledge, not clinically verified treatments.

• Next.js (static export) · React · TypeScript
• Tailwind CSS · Framer Motion · lucide-react
• Zustand (local state) · Fuse.js (fuzzy search) · Zod
• PWA (custom service worker) · deployed on GitHub Pages

git clone https://github.com/PDFly-source/niramay.git
cd niramay
npm install
npm run dev

Then open the printed local URL (development serves at the site root).

For a production build with the /niramay base path used by GitHub Pages:

NEXT_PUBLIC_BASE_PATH=/niramay npm run build
npx serve out

Visit the live app in a supported browser and choose Install app / Add to Home Screen from the browser menu. Niramay then works offline like a native app.

Current release: Niramay 2.1.0 — Public Release

• Core wellness knowledge experience (remedies, plants, categories, symptoms)
• Multilingual search — English / অসমীয়া / Roman Assamese
• Universal command palette (Ctrl+K)
• Local AI assistant with safety-first red-flag handling
• Installable PWA with offline support
• Official Niramay visual identity, light & dark mode
• Responsive mobile-first UX
• Interactive wellness tools (dosha, Ritucharya, scanners, habits)

• Physical-device QA pass (voice input, Android keyboard behavior)
• More medicinal plants and regional remedy variations
• Deeper offline ingredient-scanner guidance
• Print-friendly remedy formats

Niramay is not an open-source project, so this section is not a call for code reuse. Suggestions and issue reports are welcome via the issue tracker. Any contribution that might be accepted would require explicit permission and terms from the project owner — opening an issue does not grant source-code reuse rights. Please keep reports factual and include steps to reproduce.

Niramay is not an open-source project. Its original source code and original project assets are proprietary and remain under the control of the project owner, as stated in LICENSE.md.

The repository is publicly viewable, but public visibility does not grant permission to copy, modify, redistribute, repackage, sublicense, or commercially reuse the Niramay source code. Niramay is available for use through the official deployed web application; third-party dependencies and assets remain subject to their respective licenses (see THIRD_PARTY_NOTICES.md).

• Niramay is publicly accessible, but source visibility is not source-code licensing — the code may be read, not reused.
• Third-party components retain their own licenses and are not claimed by this project.
• Because Niramay is a client-side app, browser-delivered code can always be inspected with developer tools; the license governs permission, not technical access. See REUSE_POLICY.md.
• Copyright applies to Niramay's original code, writing, organization, UI implementation, and project-owned branding — not to the underlying traditional home-remedy knowledge, which belongs to the communities and traditions it comes from.
• For licensing or reuse permissions, contact the project owner through the repository.

• The traditional Assamese and Indian household knowledge this app organizes, carried by generations of home practitioners.
• Built with open-source tools: Next.js, React, Tailwind CSS, Framer Motion, Zustand, and Fuse.js.

Niramay · Traditional Kitchen Remedies

Built with care for everyday learning and exploration.

Live Demo · GitHub · Releases · Issues