Skip to content

RAR1741/redalert1741.org

Repository files navigation

redalert1741.org

The official website for Red Alert Robotics — FIRST Team 1741, built with Hugo and deployed to GitHub Pages.

🚀 Quick Start

Prerequisites

Local Development

# Install dependencies
npm install

# Start dev server with live reload
hugo server -D

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

Build for Production

hugo --minify

Output goes to the public/ directory.

📁 Project Structure

├── .github/workflows/    # GitHub Actions CI/CD
├── assets/css/            # Tailwind CSS source
├── content/               # Markdown content (pages, blog posts, etc.)
├── data/                  # Structured data (team info, sponsors, etc.)
├── docs/                  # Documentation (CMS setup guide, plan)
├── layouts/               # Hugo templates
│   ├── _default/          # Base templates (single, list)
│   ├── partials/          # Reusable components (header, footer)
│   └── index.html         # Homepage
├── static/
│   ├── admin/             # Decap CMS (index.html + config.yml)
│   └── images/            # Static files (images, favicon, uploads)
├── hugo.toml              # Hugo configuration
└── tailwind.config.js     # Tailwind CSS configuration

✏️ Adding Content

New Blog Post

hugo new blog/my-new-post.md

Then edit the generated file in content/blog/. Set draft: false when ready to publish.

Editing Pages

All content lives in the content/ directory as Markdown files with YAML front matter. Edit them directly or use the CMS at /admin/.

Using the CMS

Non-technical team members can edit content through the browser-based CMS:

  1. Go to https://redalert1741.org/admin/ (or http://localhost:1313/admin/ locally)
  2. Click Login with GitHub
  3. Create/edit blog posts, robot pages, sponsors, and more

See docs/CMS-SETUP.md for full setup and usage instructions.

🛠️ Tech Stack

Component Tool
Static Site Generator Hugo
CSS Framework Tailwind CSS
CI/CD GitHub Actions
Hosting GitHub Pages
CMS Decap CMS (via Netlify OAuth)

🚢 Deployment

Pushing to master automatically triggers a GitHub Actions workflow that builds the site and deploys it to GitHub Pages. No manual steps required.

Setup: In your repository settings, go to PagesBuild and deployment → set source to GitHub Actions.

📝 License

© Red Alert Robotics, FIRST Team 1741

About

Hosts the code for the public-facing team website

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors