🏛️ ATLAS (Archive Tools & Library Automation Suite)

ATLAS is a lightweight, cross-platform desktop application designed to streamline workflows for librarians, catalogers, and digital archivists. Built with a modern, glassmorphism UI, it serves as a centralized hub for data conversion, validation, and processing tasks required to maintain robust local historical archives and library systems.

---

✨ Core Features

• Modular Architecture: A centralized dashboard hub for various library cataloging tools.
• Zero-Dependency Parsing: Converts raw .mrk (MARC21) exports from Koha and Destiny into clean, structured CSV files natively in the browser engine.
• Modern UI/UX: Features an interactive dashboard, drag-and-drop file zones, real-time analytics, dynamic table previews, and custom scrollbars.
• Privacy First: All processing happens locally on your machine. No data is sent to external servers.

---

🧩 Current & Planned Modules

🟢 Active: MARC21 to CSV Converter

Instantly parse text-based MARC21 records into standard web-upload templates. Extracts standard subfields (Authors, Titles, Publication Years, Call Numbers) and intelligently classifies resource types (Books, Theses, E-Resources) using MARC leader bytes. Includes live search filtering and metric dashboards.

🟡 Coming Soon: MARC21 Field Validator (Placeholder)

A pre-upload scanning utility that flags missing call numbers, invalid dates, and incomplete titles in your `.mrk` exports to ensure high-quality database imports.

🟡 Coming Soon: Barcode & Spine Label Generator (Placeholder)

Automatically generate printable, standardized spine label sheets (e.g., Dewey or LC) and scannable library barcodes derived directly from catalog Call Numbers.

🟡 Coming Soon: Dublin Core / OAI-PMH Exporter (Placeholder)

Convert local repository records into standardized XML formats, ensuring seamless integration with larger digital heritage networks and institutional archives.

---

🚀 Getting Started

Follow these instructions to set up the ATLAS development environment on your local machine.

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js (v14 or higher)
• Rust (Required for the Tauri backend)
• Visual Studio Code (Recommended IDE)

🛠️ Development Setup

1. Clone the repository

   git clone [https://github.com/yourusername/atlas-library-suite.git](https://github.com/yourusername/atlas-library-suite.git)
   cd atlas-library-suite

2. Install Dependencies

   npm install

3. Run the development server Launch the app in development mode with hot-reloading enabled.**

   npm run tauri dev

4. Build for Production Compile a standalone executable (.exe, .app, or .deb) for deployment.**

   npm run tauri build

📁 Project Structure

atlas-library-suite/
├── src/ # Frontend Vanilla JS environment
│ ├── index.html # Main application UI and view routing
│ ├── style.css # Glassmorphism styling and UI design system
│ ├── main.js # Navigation, event handling, and DOM logic
│ └── parser.js # Core processing engine for MARC/CSV conversion
├── src-tauri/ # Rust backend and native window configurations
│ ├── src/
│ ├── tauri.conf.json # Tauri app identifiers and build targets
│ └── Cargo.toml # Rust dependencies
├── package.json # Node project configuration
└── README.md # Project documentation

UI/UX Design System

• Color Palette: Deep navy backgrounds (#090d16) accented with vibrant sky blue (#38bdf8) and glowing borders.
• Typography: Plus Jakarta Sans for clean, highly legible data presentation.
• Interactivity: Hover-responsive cards, shrinking UI headers, and smooth view transitions without page reloads.

Contributing

We welcome contributions to expand the ATLAS module library! If you have a feature request or bug report, please open an issue or submit a pull request.

1. Fork the Project

2. Create your Feature Branch (git checkout -b feature/AmazingModule)

3. Commit your Changes (git commit -m 'Add some AmazingModule')

4. Push to the Branch (git push origin feature/AmazingModule)

5. Open a Pull Request