JA
jasonappah/hackutd24
Mirror of phamleduy04/hackutd24 to enable deploying to my personal Cloudflare Pages account
HACKUTD24
โฏ REPLACE-ME
Built with the tools and technologies:
Table of Contents
๐ Overview
โฏ REPLACE-ME
๐พ Features
โฏ REPLACE-ME
๐ Project Structure
โโโ hackutd24/
โโโ .github
โ โโโ workflows
โโโ 3D_MODEL.md
โโโ backend
โ โโโ .dockerignore
โ โโโ .env.example
โ โโโ .gitignore
โ โโโ Dockerfile
โ โโโ baseline.jpg
โ โโโ docker-compose.yml
โ โโโ eslint.config.mjs
โ โโโ jest.config.js
โ โโโ package.json
โ โโโ pnpm-lock.yaml
โ โโโ src
โ โโโ tsconfig.json
โโโ car-hub
โ โโโ .gitignore
โ โโโ Pipfile
โ โโโ Pipfile.lock
โ โโโ README.md
โ โโโ main.py
โโโ embedded
โ โโโ .gitignore
โ โโโ .vscode
โ โโโ platformio.ini
โ โโโ src
โโโ frontend
โ โโโ .gitignore
โ โโโ README.md
โ โโโ components.json
โ โโโ eslint.config.js
โ โโโ index.html
โ โโโ package.json
โ โโโ pnpm-lock.yaml
โ โโโ postcss.config.js
โ โโโ public
โ โโโ src
โ โโโ tailwind.config.js
โ โโโ tsconfig.app.json
โ โโโ tsconfig.json
โ โโโ tsconfig.node.json
โ โโโ vite.config.ts
โโโ package.json
โโโ pnpm-lock.yaml
โโโ sonar-project.properties
โโโ terraform
โ โโโ .gitignore
โ โโโ README.md
โ โโโ main.tf
โโโ test.txt๐ Project Index
HACKUTD24/
__root__
pnpm-lock.yaml โฏ REPLACE-MEtest.txt โฏ REPLACE-MEpackage.json โฏ REPLACE-ME
.github
workflows
deploy.yml โฏ REPLACE-MEpr-review.yml โฏ REPLACE-MEeslint.yml โฏ REPLACE-MEdocker-build.yml โฏ REPLACE-ME
backend
pnpm-lock.yaml โฏ REPLACE-MEtsconfig.json โฏ REPLACE-MEeslint.config.mjs โฏ REPLACE-MEpackage.json โฏ REPLACE-ME.env.example โฏ REPLACE-MEdocker-compose.yml โฏ REPLACE-MEjest.config.js โฏ REPLACE-MEDockerfile โฏ REPLACE-MEsrc
server.ts โฏ REPLACE-MEapp.ts โฏ REPLACE-MEconfig
index.ts โฏ REPLACE-MEcli
createPublicGroup.ts โฏ REPLACE-MEpinata
index.ts โฏ REPLACE-MEaiPrompt
index.ts โฏ REPLACE-MEtest
error.spec.ts โฏ REPLACE-MEroutes
index.spec.ts โฏ REPLACE-MEpushNotification
index.ts โฏ REPLACE-ME
terraform
main.tf โฏ REPLACE-ME
frontend
postcss.config.js โฏ REPLACE-MEtsconfig.node.json โฏ REPLACE-MEpnpm-lock.yaml โฏ REPLACE-MEtsconfig.json โฏ REPLACE-MEtailwind.config.js โฏ REPLACE-MEtsconfig.app.json โฏ REPLACE-MEpackage.json โฏ REPLACE-MEvite.config.ts โฏ REPLACE-MEindex.html โฏ REPLACE-MEcomponents.json โฏ REPLACE-MEeslint.config.js โฏ REPLACE-MEsrc
main.tsx โฏ REPLACE-MEindex.css โฏ REPLACE-MEApp.css โฏ REPLACE-MEvitest.setup.ts โฏ REPLACE-MEApp.tsx โฏ REPLACE-MEvite-env.d.ts โฏ REPLACE-MElib
utils.ts โฏ REPLACE-MErequests.ts โฏ REPLACE-MEcomponents
AppLayout.tsx โฏ REPLACE-MEAppSidebar.tsx โฏ REPLACE-MEHome.tsx โฏ REPLACE-MEui
sheet.tsx โฏ REPLACE-MEbadge.tsx โฏ REPLACE-MEsidebar.tsx โฏ REPLACE-MEscroll-area.tsx โฏ REPLACE-MEinput.tsx โฏ REPLACE-MEseparator.tsx โฏ REPLACE-MEbutton.tsx โฏ REPLACE-MEskeleton.tsx โฏ REPLACE-MEtooltip.tsx โฏ REPLACE-MEcard.tsx โฏ REPLACE-MEhooks
use-mobile.tsx โฏ REPLACE-MEtest
App.test.tsx โฏ REPLACE-MEcomponents
Home.test.tsx โฏ REPLACE-ME
embedded
platformio.ini โฏ REPLACE-MEsrc
main.cpp โฏ REPLACE-ME
๐ Getting Started
โ๏ธ Prerequisites
Before getting started with hackutd24, ensure your runtime environment meets the following requirements:
- Programming Language: TypeScript
- Package Manager: Npm, Pipenv
- Container Runtime: Docker
โ๏ธ Installation
Install hackutd24 using one of the following methods:
Build from source:
- Clone the hackutd24 repository:
โฏ git clone https://github.com/phamleduy04/hackutd24- Navigate to the project directory:
โฏ cd hackutd24- Install the project dependencies:
โฏ npm installโฏ echo 'INSERT-INSTALL-COMMAND-HERE'โฏ docker build -t phamleduy04/hackutd24 .๐ค Usage
Run hackutd24 using the following command:
Using npm ย
โฏ npm startโฏ echo 'INSERT-RUN-COMMAND-HERE'โฏ docker run -it {image_name}๐งช Testing
Run the test suite using the following command:
Using npm ย
โฏ npm testโฏ echo 'INSERT-TEST-COMMAND-HERE'๐ Project Roadmap
-
Task 1:Implement feature one. -
Task 2: Implement feature two. -
Task 3: Implement feature three.
๐ฐ Contributing
- ๐ฌ Join the Discussions: Share your insights, provide feedback, or ask questions.
- ๐ Report Issues: Submit bugs found or log feature requests for the
hackutd24project. - ๐ก Submit Pull Requests: Review open PRs, and submit your own PRs.
Contributing Guidelines
- Fork the Repository: Start by forking the project repository to your github account.
- Clone Locally: Clone the forked repository to your local machine using a git client.
git clone https://github.com/phamleduy04/hackutd24
- Create a New Branch: Always work on a new branch, giving it a descriptive name.
git checkout -b new-feature-x
- Make Your Changes: Develop and test your changes locally.
- Commit Your Changes: Commit with a clear message describing your updates.
git commit -m 'Implemented new feature x.' - Push to github: Push the changes to your forked repository.
git push origin new-feature-x
- Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
- Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!
๐ License
This project is protected under the SELECT-A-LICENSE License. For more details, refer to the LICENSE file.
๐ Acknowledgments
- List any resources, contributors, inspiration, etc. here.