Skip to content

KGeorgii/Publicat

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Publicat

Publicat is a fast, scalable, and beautiful web app that transforms any structured .csv bibliography into an interactive journal explorer. Featuring timeline views, search capabilities, and D3.js visualizations, it's the perfect way to share archival metadata with the worldβ€”instantly.

This project builds on the structure of vsesvit.vercel.app and generalizes it for any CSV-based journal archive.


πŸš€ Features

  • πŸ“‚ Plug & Play CSV Input β€” Just drop in your .csv file.
  • πŸ•°οΈ Browse by Decade β€” Explore issues across time.
  • πŸ” Search Everything β€” Find articles by author, title, translator.
  • πŸ“Š Visual Analytics β€” Unique authors per decade, country/language distributions.
  • πŸŒ™ Dark Mode by Default (with slick UI)
  • πŸ€– Future-Ready β€” Built with React (Next.js) + D3 + PapaParse
  • πŸ’¬ Built-in AI Assistant β€” Ask questions about the data in natural language

πŸ“‚ How to Use with Your Own CSV

1. Format Your CSV

Your .csv file should have the following columns (headers must be exact):

journal_id,journal_name,journal_year,journal_number,article_name,author,translator,country,country_latin,language,language_latin

You can leave fields blank if not applicable.

2. Add Your File

Put your .csv inside the /public/data/ folder.

Rename it something like my_journal_data.csv.

3. Update Code References

Search across the codebase and update:

const CSV_URL = '/data/data_2.csv';

To:

const CSV_URL = '/data/my_journal_data.csv';

This is found in:

  • index.tsx
  • search.tsx
  • visualizations.tsx
  • ai_chat.tsx

4. (Optional) Update Branding

Edit:

<title>Vsesvit</title>

To:

<title>Publicat</title>

Also update logos, meta descriptions, and about.tsx for your own flavor.


🚒 Deploy on Vercel

Option 1: Via GitHub

  • Push your project to GitHub
  • Go to vercel.com
  • Connect your repo & deploy

Option 2: Via CLI

npm install -g vercel
vercel

Follow the interactive prompts.


πŸ”§ Tech Stack


πŸ’ͺ Contributing

Have a cool CSV use case? Want to improve visualizations? PRs are welcome!

  1. Fork the repo
  2. Clone it locally
  3. Install dependencies:
npm install
  1. Run dev server:
npm run dev

πŸ“ž Contact

Created by @KGeorgii. Feel free to open issues or reach out for collaboration ideas!


✈️ License

MIT License.



Vercel OSS Program

Vercel OSS Program

About

Open Periodicals for a Connected World

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors