Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

add readme for www #111

Merged
merged 1 commit into from
Apr 24, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ This repository, built using [Turborepo](https://github.com/vercel/turbo), utili

### Apps and Packages

- `apps/web`: web application built using the [Next.js framework](https://github.com/vercel/next.js/)
- `apps/www`: web application built using the [Next.js framework](https://github.com/vercel/next.js/)
- `apps/docs`: documentation site built using [Nextra](https://github.com/shuding/nextra)
- `packages/opub-ui`: a library of reusable React components used in both the web and docs applications.
- `packages/eslint-config-custom`: `eslint` configurations for the eslint tool, including `eslint-config-next` and `eslint-config-prettier`.
Expand Down
53 changes: 34 additions & 19 deletions apps/www/README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,51 @@
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
# OPub Web

A platform to speed up the development of Open Data Dashboards. Part of the [OPub project](https://github.com/CivicDataLab/opub-mono).

## Getting Started

First, run the development server:
To get started, you can clone the repository and run it locally using the following steps:

1. Clone the repository:

```bash
git clone https://github.com/CivicDataLab/opub-mono.git
```

2. Install dependencies

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
cd opub-mono

yarn
```

3. Start the development server:

```bash
turbo dev --filter www
```

Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## Documentation

OPub uses Next.js new `app` directory. For more information on how to use Next.js, refer to the [Next.js documentation](https://beta.nextjs.org/docs/getting-started).

You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
## Community

[http://localhost:3000/api/hello](http://localhost:3000/api/hello) is an endpoint that uses [Route Handlers](https://beta.nextjs.org/docs/routing/route-handlers). This endpoint can be edited in `app/api/hello/route.ts`.
We use Github Discussions to discuss ideas, proposals and questions about the project. You can [head over there](https://github.com/CivicDataLab/opub-mono/discussions) to interact with the community.

This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.
Our [Code of Conduct](../../CODE_OF_CONDUCT.md) applies to all community channels.

## Learn More
## Contributing

To learn more about Next.js, take a look at the following resources:
Contributions to the project are welcome! To contribute, simply fork the repository, make your changes, and submit a pull request.

- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
For more information on contributing to the project, refer to the [CONTRIBUTING.md](../../CONTRIBUTING.md) file.

You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!
## License

## Deploy on Vercel
This project is licensed under the MIT license. For more information, refer to the [LICENSE](LICENSE) file.

The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
## Security

Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
If you believe you have found a security vulnerability in OPub, we encourage you to responsibly disclose this and not open a public issue. We will investigate all legitimate reports. Email `tech@civicdatalab.in` to disclose any security vulnerabilities.