Skip to content

DynoW/cuza.pages.dev

Repository files navigation

CuzaPages

The largest archive for the Romanian baccalaureate exam β€” by students, for students.

Live site: cuza.pages.dev

Overview

CuzaPages is an open-source study platform that aggregates courses, past exam papers, and notes for Romanian high school students preparing for the baccalaureate. The site covers multiple subjects including Physics, Romanian language, and more.

Tech Stack

Layer Technology
Framework Astro v5
Styling Tailwind CSS v4
UI components React v19
Diagrams Excalidraw
Backend / API Hono on Cloudflare Workers
File storage Cloudflare R2
Hosting Cloudflare Pages
Package manager pnpm

Project Structure

cuza.pages.dev/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/     # Astro & React components
β”‚   β”œβ”€β”€ content/info/   # Course markdown files
β”‚   β”œβ”€β”€ layouts/        # Page layouts
β”‚   └── pages/          # File-based routes
β”œβ”€β”€ public/             # Static assets (fonts, images)
β”œβ”€β”€ cuza-worker/        # Cloudflare Worker (file upload / R2 API)
└── web-scraper/        # Python scraper for sourcing exam papers

Getting Started

Prerequisites

Install & run locally

pnpm install
pnpm dev

The site will be available at http://localhost:4321.

Build for production

pnpm build
pnpm preview   # serve the built output locally

Cloudflare Worker (backend)

cd cuza-worker
pnpm install
pnpm dev       # local development
pnpm deploy    # deploy to Cloudflare Workers

Contributing

See CONTRIBUTE.md for a full step-by-step guide on how to fork the repo, make changes, and open a pull request.

Quick summary

  1. Fork and clone the repository.
  2. Create or edit course files in src/content/info/.
  3. Add static assets (images, fonts) to public/. Exam PDFs are stored on Cloudflare R2 β€” use the web-scraper or the upload page to add files.
  4. Open a pull request and wait for review.

For questions or feature requests, open a GitHub Issue.

License

The site and Cloudflare Worker are licensed under the GNU Affero General Public License v3.0 (AGPL-3.0). Any fork deployed as a public web service must also publish its source code under AGPL-3.0.

The web-scraper/ utility is independently licensed under the MIT License.

Exam PDFs served on the site are produced by the Romanian Ministry of Education and are not covered by either license.

About

An archive with baccalaureate subjects from previous years πŸ§‘β€πŸŽ“ (Bacalaureat RomΓ’nia | mate, fizica, info | specializarea mate-info)

Topics

Resources

License

Stars

Watchers

Forks

Contributors