kenzhu2525 / campus-canvas

spin-off of r/place but for college campus

CSC305

Campus Canvas is a community-driven mobile app with a unique twist: users must physically visit specific real-life locations to place virtual pixels based on their real-world location. This app draws inspiration from Reddit, particularly the subreddit r/Place, where a vast canvas allowed users to add a single pixel every few minutes. With Campus Canvas, users can only place pixels once every 5 minutes, encouraging collaboration as they work together to create artwork while exploring the campus in an engaging way.

Table of Contents

• Features
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Contributing
• License

Features

• Collaborative canvas creation: Users can place virtual pixels on a canvas at real-life locations.
• Real-world exploration: Encourages users to explore their campus and visit specific locations.
• Pixel placement rate: Users can place pixels once every 5 minutes, promoting collaboration and strategy.

Getting Started

Prerequisites

• Compatible with Android devices running Android OS 7.0 (Nougat) and above.

Installation

Campus Canvas is available for download on the Google Play Store here. To install the app on your Android device, follow these steps:

1. Visit the Google Play Store on your Android device.
2. Search for "Campus Canvas" in the search bar.
3. Select the Campus Canvas app from the search results.
4. Click on the "Install" button to download and install the app on your device.
5. Once installed, open the app and follow the on-screen instructions to get started.

Usage

Upon opening the app, users are prompted to create an account or log in. Once logged in, they can:

• View the campus canvas map displaying designated locations.
• Visit these locations physically to place pixels on the canvas.
• Interact with other users' pixel placements.
• Enjoy the collaborative artwork created by the campus community.

Contributing

We welcome contributions from the community to enhance Campus Canvas. If you wish to contribute, please follow these guidelines:

1. Fork the repository and clone it to your local machine.
2. Create a new branch for your feature or bug fix.
3. Commit your changes and push your branch to your fork.
4. Submit a pull request, detailing the changes made and their purpose.

Please refer to the Contribution Guidelines for more information on contributing to this project.

License

This project is licensed under the MIT License.

---

campus-canvas's Issues

Implement a pixel placement feature where users can tap or click on the canvas to add pixels. Ensure that pixels are placed precisely at the user's input location.

Update the canvas in real-time to reflect changes made by users, allowing them to see their artwork progress as they make modifications.

Test Cases

https://docs.google.com/presentation/d/1x3rcxiuoTAYU4vUJU772_se3niniRT5yyfjKlaWNJQE/edit?usp=sharing

US 7: As a Campus Canvas developer, I want to create an engaging website to promote our app, showcasing its features and functionalities to entice and inform potential users.

Create a initial backend RTDB schema for our app.

Create an engaging user interface design for our mobile app so that users can easily can interact with the app.

US 9: As a user, I expect a revamp of the webview interface to align with the app's overall aesthetic and usability standards, ensuring a visually appealing and user-friendly experience.

Add a "Forgot Password" feature for password reset.

Revamp the error messages from various test cases

HEART Framework

https://docs.google.com/presentation/d/1ydldJPVgvp8ph8vSlYs1v9467DsVyyape3bgpzC_P0U/edit?usp=sharing

US 1: As a Campus Canvas user, I want to sign up for an account using my URI email and then be able to sign in and out as I want.

US 4: As a Campus Canvas user, I want to view my real-time location on the map and have a real-time canvas tracker, so I can navigate the campus more effectively and monitor artwork progress.

Gather Net Promoter Score: Measures user satisfaction and their likelihood to recommend the app to others. Higher NPS indicates greater user satisfaction. For more information go to METRICS.md

Business Model

https://docs.google.com/presentation/d/1t0Tgj0LdxebdV1llosvSGrhvIg_TdwaTo5xvGyB5zcA/edit?usp=sharing

Share via GitHub issue

Create a user profile page for personal information.

Log into your Campus Canvas account with your registered URI email and password to access your account whenever you need it.

US 3: As a Campus Canvas user I want to place pixels and change the colors on the canvas to create and customize my digital art.

Documentation template [tentative]

https://docs.google.com/document/d/1pkqc3cP9vPuuMgVkGe-0iwFaYLsW_8BmLzmQWSxC47s/edit?usp=sharing

Install Analytics : Key metrics for our app include user satisfaction indicators like NPS and App Rating, engagement metrics like Screen Time and Total Users Over Time etc. For more information go to METRICS.md

Database resetting values.

US 8: As a developer of Campus Canvas, I want to create a settings screen with user privileges and information.

Restructure the wiki page

Cloud function for thunkable

A button and text box that allows users to change their current username

US 6: As a Campus Canvas user I want to place a message along my pixel placement to give a description of what I am trying to make or simply leave a note.

Add a button that allows users to see the terms and agreement

A/B Testing: User Engagement with Social Features - Enhancing user engagement (HEART metric), we aim to boost average engagement time by introducing a chat room feature in the experiment group (50% of users). Refer to ABTEST.md for more information

Log out of your Campus Canvas account securely, ensuring you can't access it without signing in again.

add a map that removes the street/building names

US 5: As a Campus Canvas user, I want to view my real-time location on the map, so I can navigate the campus more effectively.

thing

https://docs.google.com/presentation/d/1HQPth8ifotEeA4WUJsn1vZO2-JDopRbwg9e43woI-yc/edit#slide=id.gc8216bd24_20_0

Show information about the user account such as email, when the date was created, etc

US 2: As a Campus Canvas user, I want the ability to save my personal information and have the option to reset my password, ensuring that my account remains accessible and my data is protected.

Sign up for a Campus Canvas account by providing your URI email and registration information, verify your email to complete the process.

Create a color palette that offers a variety of color options for users to choose from. Enable users to select colors for their pixels.

Assignment 8 1C

https://docs.google.com/document/d/1S97pmryMcmROUF7TwdanLEpJOAikW-24jsbELK70rhY/edit?usp=sharing

Host a server in order to make a website that embeds the canvas

US 10: As a user, I expect the development team to prioritize optimizing the app across a broader range of devices and operating systems, addressing reported performance issues to ensure a smoother and consistent user experience for all users facing optimization-related challenges.

A/B Testing : Pixel Placement Frequency - Users will be more engaged if allowed to place pixels every 2 minutes (experiment group) instead of every 5 minutes (control group). Refer to ABTEST.md for more information.

US 5: As an Administrator of Campus Canvas, I have the permission to create and delete user accounts on the app so that I can efficiently manage user accounts.

Thunkable app not using cloud variable to write data into firebase