Everything your campus life needs,
on the web.

Deploy any static site — HTML/CSS/JS, React, Vue, Svelte, Astro, Next.js (static export), Eleventy, Hugo, Jekyll, or literally any tool that outputs a folder of files. We run your build command, grab the output directory, and push it to our CDN.

We auto-detect most frameworks. If we can't figure it out, just tell us the build command and output directory in a bsu.json config file (or pass them as CLI flags). That's it.

Framework detection

The CLI inspects your package.json to determine your framework. For example, if it sees astro in dependencies, it knows to run npm run build and look for output in dist/. Override any of these defaults in your config.

Not building a website? No problem. Use BestSchoolUS as a file host. Upload any file type — PDFs, datasets (CSV, JSON, Parquet), images, ZIP archives, research papers, presentation slides — and share a direct download link.

Files are served with correct MIME types, proper cache headers, and optional Content-Disposition headers for forcing downloads. You control whether visitors see files in-browser or get a download dialog.

Directory listings

Enable auto-generated directory listings for any folder. Useful when sharing a collection of files — your visitors get a clean, browsable index without you writing any HTML. Listings show file names, sizes, and last-modified dates.

Hotlink protection

Don't want other sites embedding your images or burning through your bandwidth? Toggle hotlink protection per-project. Allowed referrers are configurable.

Every file you deploy is distributed to 12 edge locations across North America. We use a combination of regional caching and origin shielding to keep TTFB low — under 45ms on most campus networks, under 80ms from anywhere in the continental US.

Asset files (JS, CSS, images, fonts) are served with long-lived cache headers and content-based hashes. HTML files get short cache TTLs so your latest deploy is live within seconds.

Automatic optimization

• Brotli + gzip compression on all text assets
• Automatic immutable cache headers for hashed filenames
• HTTP/2 multiplexing and server push for critical assets
• Early hints (103) for repeat visitors
• Optional image optimization (WebP/AVIF conversion) on Pro plans

Every project gets a free *.bestschoolus.com subdomain. Want your own domain? Add a CNAME record pointing to cname.bestschoolus.com and we'll provision an SSL certificate automatically via Let's Encrypt.

Certificate renewal is fully automated. You never need to think about it. We support both root domains and subdomains, and you can map multiple domains to the same project.

Subdomain naming

Your default subdomain is derived from your username. You can claim additional project-specific subdomains like capstone.bestschoolus.com or my-research.bestschoolus.com. Subdomains are first-come, first-served and must be 3+ characters.

Connect a GitHub or GitLab repository and we'll deploy automatically on every push to your production branch. Branch deploys are supported too — every branch gets a unique preview URL so you can share work-in-progress with teammates or TAs.

Deploy hooks & commit status

We post commit status checks back to GitHub/GitLab so you can see deploy progress right in your PR. Failed builds surface error logs in the commit status detail page.

Monorepo support

If your repo contains multiple projects (e.g., frontend/ and docs/), configure each as a separate BSU project with its own subdomain. We only rebuild the project whose files changed.

The @bestschoolus/cli package is a lightweight Node.js CLI that handles authentication, project creation, deploys, domain management, and log tailing. Install it globally and you're set.

Available commands

Every project comes with privacy-respecting analytics. No cookies, no tracking scripts, no GDPR banner required. We count page views, unique visitors, top referrers, and popular paths using server-side log analysis.

Data is aggregated hourly and retained for 90 days on the free plan. Pro plans get real-time analytics, 1-year retention, and exportable CSV reports.

Access logs

Tail raw access logs in real time with bsu logs --follow. Useful for debugging 404s, checking if your latest deploy is live, or monitoring traffic during a demo.

Deploy history

Every deploy is recorded with timestamp, commit hash, file count, and total size. Browse your deploy timeline in the dashboard or via bsu deploys.

Working on a group project? Invite teammates to your project with role-based permissions. Owners manage settings and domains. Developers can deploy and rollback. Viewers can see analytics and logs.

Shared deploy history

See who deployed what, when. The deploy log shows the committer, commit message, build duration, and status for every deploy. Handy for debugging "who broke the site."

Department accounts

CS departments and research labs can request a department account. These get higher storage quotas (50 GB), priority support, and a shared project namespace like cs.gatech.bestschoolus.com.