Skip to content

README.md

Latest commit

 

History

History
108 lines (77 loc) · 3.06 KB

README.md

File metadata and controls

108 lines (77 loc) · 3.06 KB

IndopenSource.org

Deploy to GitHub Pages License: MIT

Website roadmap untuk https://indopensource.org.

Tech Stack

  • Astro
  • Tailwind CSS
  • TypeScript
  • GitHub Pages
  • GitHub Actions

Pages

  • Home: ringkasan roadmap dan arah website.
  • Falsafah: prinsip komunitas dan kurasi open source Indonesia.
  • Projects: direktori dari IndopenSource/awesome-indonesia.
  • Blog: placeholder untuk repo khusus IndopenSource/Blog-IndopenSource.
  • Forum: rencana integrasi https://github.com/orgs/IndopenSource/discussions.
  • Contact: kanal GitHub organization, projects, dan discussions.

Development

npm install
npm run sync:projects
npm run dev

Project Structure

src/
  components/   Reusable Astro UI components
  data/         Synced project directory data
  layouts/      Shared page layout
  lib/          Small shared helpers
  pages/        Route files
  styles/       Tailwind entrypoint and theme tokens

Checks

npm run check
npm run build

MVP Pre-release

MVP awal berfokus pada homepage sebagai pintu masuk roadmap IndopenSource:

  • Home menjelaskan posisi indopensource.org.
  • Projects sudah punya data awal dari awesome-indonesia.
  • Falsafah, Blog, Forum, dan Contact tersedia sebagai halaman roadmap.
  • Deployment memakai GitHub Pages bawaan repo lewat GitHub Actions.

Rilis pre-release bisa dibuat dari tag v0.1.0-mvp setelah workflow Pages hijau. URL produksi setelah custom domain aktif adalah https://indopensource.org/.

Deployment

GitHub Pages memakai workflow .github/workflows/deploy-pages.yml.

  • Build command: npm run build
  • Output directory: dist
  • Source: GitHub Actions
  • Custom domain: indopensource.org
  • Pages base path: /

Aktifkan Pages di repository settings dengan source GitHub Actions, lalu push ke main atau jalankan workflow Deploy to GitHub Pages secara manual.

Project Sync

npm run sync:projects membaca repos.json dari IndopenSource/awesome-indonesia, lalu mengambil metadata repo dari GitHub API dan menulis hasilnya ke src/data/projects.json.

Gunakan GITHUB_TOKEN atau GH_TOKEN untuk rate limit yang lebih lega.

Blog Sync

npm run sync:blog membaca artikel Markdown dari IndopenSource/Blog-IndopenSource, mengambil metadata commit penulis/rilis, dan menulis hasilnya ke src/data/blog-posts.json.

Auto Sync

Workflow .github/workflows/sync-content.yml memperbarui data secara otomatis.

  • Manual: jalankan workflow Sync content data.
  • Schedule: berjalan setiap 6 jam.
  • Dispatch dari repo lain:
    • sync-projects
    • sync-blog
    • sync-content

Jika data berubah, workflow membuat commit Sync content data. Setelah commit masuk main, workflow yang sama akan upload artifact dan deploy ulang GitHub Pages agar perubahan data langsung tayang.

Contributing

See CONTRIBUTING.md.