History

Rodolfo b3e87772ec gui fixes		2025-12-09 22:02:14 -05:00
..
scripts	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
src	gui fixes	2025-12-09 22:02:14 -05:00
.claudeignore	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.crev-config.yaml	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.env.development	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.env.development.sample	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.env.example	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.env.production	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.env.production.sample	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
.gitignore	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
eslint.config.js	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
index.html	gui fixes	2025-12-09 22:02:14 -05:00
package-lock.json	feat: Implement email change functionality	2025-12-05 15:29:26 -05:00
package.json	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
postcss.config.js	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
README.md	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
tailwind.config.js	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
Taskfile.yml	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00
vite.config.js	Initial commit: Open sourcing all of the Maple Open Technologies code.	2025-12-02 14:33:08 -05:00

README.md

⚛️ MapleFile Frontend (React + Vite)

End-to-end encrypted file storage frontend built with React 19 and Vite.

🚀 Quick Start

Development Setup

# Install dependencies
npm install

# Copy environment template
cp .env.development.sample .env.development

# Start dev server
npm run dev

The frontend runs at http://localhost:5173

Production Setup

# Copy environment template
cp .env.production.sample .env.production

# Edit .env.production with your production settings
# At minimum, set: VITE_API_BASE_URL

# Build for production
npm run build

# Preview production build locally
npm run preview

⚙️ Environment Configuration

Environment files are not tracked in git. Use the .sample files as templates:

.env.development.sample → Copy to .env.development (local dev)
.env.production.sample → Copy to .env.production (production build)

Key variables:

Variable	Description	Default
`VITE_API_BASE_URL`	Backend API endpoint	`http://localhost:8000` (dev)
`VITE_DEV_MODE`	Development mode flag	`true` (dev)

Session Persistence

Users can choose their session persistence preference via the "Keep me logged in" checkbox on the login page:

Checked - Uses localStorage to stay logged in after closing browser
Unchecked - Uses sessionStorage for session-only persistence (logged out on browser close)

The preference is stored and remembered for future logins.

🤝 Contributing

Found a bug? Want a feature to improve MapleFile Frontend? Please create an issue.

📝 License

This application is licensed under the GNU Affero General Public License v3.0. See LICENSE for more information.