Web-based dashboard containing a variety of visualizations and interactive elements for personal data tracking, analysis and monitoring.
This is an improved version of one of my archived projects from 2021 when I was relatively new to NextJS. The original repositories can be found at the links below:
Dash V2 is built using NextJS with PostgreSQL, and containerized using Docker.
-
The
appdirectory contains all the routes for the application, including the REST API endpoints. -
Configuration files for the project can be found in
lib/config.tsfile. -
All the reusable client-side components are stored in the
componentsdirectory. -
The schema files for the database is stored in the
databasedirectory. since it's a relatively small project and I wanted to avoid unnecessary dependencies,the migration files are generated manually. Ideally they'd be generated automatically through tools like Prisma.
demo_20250319.mp4
The project comes with a docker-compose.yml file that sets up the
development environment for the project. To get started, you need to
have Docker installed on your machine. You can download Docker from
the official website.
In the project root directory, create a .env file and copy the
contents of the .env.example file into it. Then, update the values
of the environment variables in the .env file based on the table
below:
| Variable | Description |
|---|---|
PG_* |
Leave as-is unless using an external database outside Docker. |
NEWS_API_KEY |
Register at NewsAPI and copy your API key |
TSS_QUOTE_API_KEY |
Register at TheySaidSo and copy your Quote API key |
SPOTIFY_CLIENT_ID |
Create an app on Spotify for Developers, then retrieve theClient ID and Client Secret from your app |
NEXTAUTH_SECRET |
Generate a random string and use it as the secret for NextAuth |
Run the following command to start the development environment:
PG_U=postgres PG_P=password docker-compose up --buildThe project will be available at http://localhost:3000
This project is licensed under the MIT License.
See the LICENSE file for details.