AncientPath

Platform productivity tools gratis — dokumentasi Excel, kalkulator, dan konverter.

Bukan blog. Bukan website AI. Bukan landing page. Platform tools yang dibangun untuk bertahan bertahun-tahun.

Fitur

• Dokumentasi Excel — 10 rumus Excel dengan sintaks, parameter, dan contoh
• Excel Calculator — 3 kalkulator (Percentage, Average, Basic Sum)
• Excel Converter — 3 konverter (Length, Weight, Temperature)
• Pencarian global — Cari rumus, kalkulator, atau konverter
• Mode gelap/terang — Toggle tema dengan persistensi lokal
• Fully static — Semua halaman di-generate saat build, zero server runtime

Tech Stack

Lapisan	Teknologi
Framework	Next.js 16.2.10 (App Router)
Build Tool	Turbopack
Bahasa	TypeScript (strict)
CSS	Tailwind CSS v4
Ikon	lucide-react
Deployment	Static export (SSG)

Runtime dependencies: hanya 4 (next, react, react-dom, lucide-react).

Prasyarat

• Node.js 20+
• npm
• WSL (untuk build di Windows — lihat catatan di bawah)

Instalasi

git clone https://github.com/abcodeworks-team/AncientPath
cd AncientPath
npm install

Development

npm run dev

Buka http://localhost:3000.

Build

Linux / macOS / WSL

npm run build

Windows (native)

Build membutuhkan lightningcss native. Gunakan WSL:

npm install
npm run build

Output statis di .next/.

Struktur Proyek

src/
├── app/                    # App Router pages
│   ├── excel/
│   │   ├── formulas/       # Halaman detail rumus (SSG)
│   │   ├── calculators/    # Halaman kalkulator (SSG)
│   │   └── converter/      # Halaman konverter (SSG)
│   ├── globals.css         # Design system + tokens
│   ├── layout.tsx          # Root layout
│   ├── not-found.tsx       # Halaman 404
│   ├── robots.ts           # Robots.txt
│   ├── sitemap.ts          # Sitemap.xml
│   └── error.tsx           # Error boundary (client)
├── components/
│   ├── ui/                 # Komponen umum (Badge, Card, Button, dll)
│   ├── search/             # Pencarian global (client)
│   └── app-shell.tsx       # Layout shell (server)
├── config/
│   └── site.ts             # SITE_CONFIG, ROUTES
├── lib/
│   └── registry/           # ModuleRegistry, ContentRegistry, SEO, Search
└── modules/
    └── excel/              # Module Excel
        ├── components/     # FormulaDetail, CalculatorForm, ConverterForm
        ├── data/           # Formula definitions, calculator logic
        └── types/          # TypeScript types

Arsitektur

• Server Components sebisa mungkin — "use client" hanya untuk interaktivitas
• Module Registry — sistem plugin untuk ekspansi kategori tools
• Static Site Generation (SSG) — semua halaman di-generate saat build
• Registry pattern — content, search, SEO, routing via registry terpusat

Skrip

Perintah	Deskripsi
npm run dev	Development server
npm run build	Production build
npm run start	Serve hasil build
npm run lint	Lint

Deployment

Build menghasilkan output static. Deploy ke Vercel, Netlify, atau static host manapun.

Konfigurasi environment (.env.local):

NEXT_PUBLIC_SITE_URL=https://domain-kamu.com

License

This project is licensed under the Apache License.