Skip to content

theebayuser/usamo-guide

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27,891 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

USAMO Guide

USAMO Guide

A free, open-source platform for AMC, AIME, and USAMO preparation.

USAMO Guide aims to provide a structured pathway from AMC → AIME → USAMO, combining curated learning resources, regular contests, and a contributor-driven community.

Most olympiad students currently rely on scattered resources across multiple sites. Our goal is to build a single platform where students can learn, practice, compete, and contribute.


What We're Building

Structured Study Resources

A modular learning system covering:

  • Algebra
  • Number Theory
  • Geometry
  • Combinatorics

Each topic includes explanations, curated problems, and full solutions organized by increasing difficulty.

Regular Contests

We plan to host recurring online contests with:

  • Timed competition environments
  • Automatic scoring for objective rounds
  • Manual grading for proof-based problems
  • Global rankings and leaderboards

This allows students to benchmark their progress and compete internationally.

Community and Contributors

USAMO Guide is community-built.

Contributors can help by:

  • Writing learning modules
  • Creating problems and solutions
  • Reviewing content
  • Helping with contests

Contributors receive public recognition and the chance to build something meaningful for the olympiad community.


Documentation + Contributing

See docs/Math_Topic_Template.md for content guidelines. All contributions are welcome! To get started, simply pick an issue you'd like to work on, leave a comment, and submit a Pull Request!

Our Team

The USAMO Guide is run by the USAMO Guide team. We're looking for content authors to help us improve the Guide.

Join the Discord Server to meet us! : https://discord.gg/PMyJgWjAz9

Tech Stack

Our front-end is built with:

  • React
  • Gatsby
  • Typescript
  • Tailwind CSS
  • Storybook and Chromatic
  • MDX (JSX in Markdown) with XDM compiler
  • Supabase (Auth + Postgres + Storage)

Contact Info

If you have any questions, please reach out to us at [email protected]

License

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Acknowledgements

We would like to express our sincere appreciation to the USACO Guide team and contributors. Their open-source work served as an important reference while building USAMO Guide. The structure, engineering decisions, and overall philosophy behind the project were incredibly helpful as we developed our own platform.

In particular, the availability of their codebase made it significantly easier for us to understand how a large educational resource platform can be organized and maintained. Many aspects of our development process were informed by the design patterns and infrastructure used in USACO Guide. We are grateful to their team for openly sharing their work and helping make projects like this possible.

About

The All-in-one Guide for Getting USAMO/JMO Qual :)

Resources

License

Code of conduct

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 54.4%
  • TeX 19.2%
  • MDX 11.2%
  • JavaScript 4.7%
  • CSS 4.5%
  • HTML 3.8%
  • Other 2.2%