Sanlung / ctd-practicum-slaty-egret

A repo for the Code the Dream React - Egret students' collaborative work on a React app.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Whatodo App

Project Picture 1

A Todo App Built on Next.js with Firebase Auth and Cloud Firestore

Project by Code the Dream Spring 2022 Practicum - Slaty Egret Team

react version nextjs version firebase version mit license

Code the Dream Logo

Code the Dream offers free intensive training in software development to people from diverse low-income backgrounds. Its Practicum curriculum offers opportunities for the Code the Dream School trainees to work collaboratively in dev teams on real-life, deployable software engineering projects.

About

This project is the work by team Slaty Egret of the Code the Dream Spring 2022 Practicum to develop a todo app bootstrapped with Create Next App using Firebase Authentocation and Cloud Firestore. The app is deployed on Firebase for personal use by the team members and as the final exercise of the project.

Installation

Clone or fork from this repo if you would like to tweak and add features to the app. You may push a branch back here to give us feedback on how the app has been taken further. You can also clone the app to use it personally in your browser. The app has minimal dependencies and can easily be set up with a Google account, which come with access to Firebase, as follows. In your terminal, run:

$ git clone https://github.com/Sanlung/ctd-practicum-slaty-egret.git

or

$ git clone git@github.com:Sanlung/ctd-practicum-slaty-egret.git

Once you have cloned the repo, in your local project directory run:

$ npm install

Next, go to the Firebase website and sign in with your Google account. Follow their official documentation to set up a project⎯which can be done with the Spark plan that is free⎯and add your app to the project. In the project console, go to Project Settings, copy the configuration keys for using the Firebase SDK, and create a .env.local file for those keys in the root directory of your project. The configuration variables will then be imported in the /config/firebaseConfig.js file that you cloned along with the project.

Firebase Config

Return to the Firebase console and follow the on-screen instructions to add Cloud Firestore and Authentication to your project⎯choose email and password as the sign-in method. You can find help in the official documentation should you feel uncertain.

Now you are all set and ready to use the Whatodo App.

Usage

In your project directory run:

$ npm run dev

And you have the app in port localhost:3000.

Whatodo App login page

Sign up with an email and set your password, and enjoy your own todo app.

Whatodo App logged in page Whatodo App logged in page - mobile Whatodo App logged in page - mobile sidebar toggle

You can sort a list chronologically, and may search items in the lists or list names for a certain keyword.

Whatodo App search interface

Please let us know of any bugs or imperfections. Your input will be greatly appreciated. It has been a wonderful learning experience for us.

Contributors

Asel Karagazieva Chung Kao Ignat Babenko

About

A repo for the Code the Dream React - Egret students' collaborative work on a React app.


Languages

Language:JavaScript 76.2%Language:CSS 23.8%