Wishing Plan allows the user to tracks savings and calculates purchase feasibility of the user's wishes. It will also become a hub for planning bigger purchases with others, creating individual or collective wish lists to share on occasions like birthdays, Christmas and more.
Wishting Plan is an open source project. We welcome contributions from the community. There are many ways to contribute to the project, from writing tutorials or blog posts, submitting bug reports and feature requests or writing code which can be incorporated into Wishing Plan itself. Here is a list of some of the ways you can contribute to the project:
- Report bugs - If you find a bug, please report it in the issue tracker.
- Suggest new features - If you have an idea for a new feature, please suggest it in the issue tracker.
- Implement new features - If you want to implement a new feature, please create an issue in the issue tracker and describe the feature you want to implement. This will allow us to discuss the feature and make sure it fits with the project.
- Improve code quality - We use SonarCloud and CodeScene to measure the code quality of our project. You can help us improve the code quality by fixing bugs and vulnerabilities.
- Improve documentation - If you find any errors in the documentation or want to improve it, please contribute with a pull request.
- In the future, we will want to implement translations of the app. If you are interested in helping us with this, please contact us at wishing.plan.com@gmail.com.
- Use node version "^12.19.0 || ^14.15.0 || ^16.13.0 || ^18.12.0"
- This is because of the compatibility of next-auth@4.17.0
- Install yarn globally
npm install -g yarn
- Insdall Docker e.g., Docker Desktop for Windows or Docker Engine for Linux. See Docker installation for more information.
- This is to have a local database for development.
- Install win-node-env globally
npm install -g win-node-env
to be able to run e.g.,yarn db-seed
on Windows.
- Clone the repository
- Create local .env
cp .env.example .env
and fill in the values - Install dependencies
yarn install
or justyarn
- Start the database
docker-compose up -d
- Run
yarn db-push
to migrate the database - Run
yarn db-seed
to seed the database with test data - Run the development server
yarn dev
IMPORTANT: In order to see our project board on ZenHub, you need to have an account and have connected it with your GitHub account.
For development management we are using ZenHub Board. It is recommended to install the browser extension for ZenHub, to be able to view information from our ZenHub board within GitHub.
NOTE: ZenHub is not required however, as the issues we are working on are shared between GitHub and ZenHub.
Here is the current overview of the code health of the repository measured by:
- Sonarcloud: https://sonarcloud.io/summary/overall?id=Andreasgdp_Wishing-Plan
- CodeScene: https://codescene.io/projects/33413/jobs/781250/results
- Component library: https://chakra-ui.com/docs/components
The smallest width we will accomidate for the webpage is 240px.
This is a T3 Stack project bootstrapped with create-t3-app
.
To learn more about the T3 Stack, take a look at the following resources:
- Documentation
- Learn the T3 Stack — Check out these awesome tutorials