Sumbula

Parent repository for the Sumbula academic journal. Uses Open Journal Systems (OJS) and brings together three existing community repos as submodules.

Structure

Path	Purpose
ojs/	OJS core (PKP submodule); config and public assets
Academicjournalwebsitecommunityfixed/	Submodule — academic journal website and community
Onlineacademicjournalwebsitecommunity/	Submodule — online academic journal site
Homepageforresearchjournalcommunity/	Submodule — homepage for the research journal community
docs/	Setup, deployment, and OJS configuration. See docs/deployment.md for Figma mapping and Vercel/Netlify config.

Setup

1. Clone with all submodules (OJS + the three community repos):

   git clone --recurse-submodules https://github.com/ascendanti/Sumbula.git
   cd Sumbula

   If you already cloned without submodules:

   git submodule update --init --recursive

2. OJS: See docs/setup.md for installing and configuring OJS (e.g. in ojs/ or a separate path).

3. Community submodules: Each of the three subfolders is its own GitHub repo; work in them as usual and push from the submodule directory, or update the parent’s submodule reference after pushing.

Requirements

• Git — clone and submodules
• Node.js 20+ — for the three community apps (npm i, npm run dev) and OJS frontend build (npm run build in ojs/)
• PHP 8.2+ — for OJS only; see ojs/README.md
• Database — MySQL 5.7.22+, MariaDB 4.1+, or PostgreSQL 9.5+ for OJS
• Web server — Apache or Nginx for OJS (and optionally for serving the built community apps)
• Optional: Supabase project and keys for Academicjournalwebsitecommunityfixed and Onlineacademicjournalwebsitecommunity (see .env.example in those folders)

Full steps: docs/setup.md. OJS details: PKP documentation.

License

See individual subprojects and OJS for licensing.